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About This Manual 





This guide provides information on shutting down and starting up your system and 
identifies the processor-specific boot commands for the processors supported by the 
ULTRIX operating system. It also provides a description of the standalone ULTRIX 
environment. 


Audience 


The ULTRIX Guide to System Shutdown and Startup is written for the person 
responsible for managing and maintaining an ULTRIX system. It assumes that this 
individual is familiar with ULTRIX commands, the system configuration, the 
system’s controller/drive unit number assignments and naming conventions, and an 
editor such as vi or ed. You do not need to be a programmer to use this guide. 


Organization 

This manual consists of four chapters, two appendixes, and an index: 

Chapter 1: Explains the various ways that you can shut down the system. 

Chapter 2: Explains the three modes that you can use to start up the system: 
single-user, multiuser, and conversational (VAX only). 

Chapter 3: Identifies and describes the boot commands supported by the ULTRIX 
system. 

Chapter 4: Describes the purpose and functionality of the Standalone ULTRIX 


Environment and explains how to invoke it. 


Appendix A: Lists the supported device mnemonics and explains how to obtain 
detailed reference page information on devices. 


Appendix B: Shows how the VMB program uses the general purpose registers. 


Related Documentation 


You should have the hardware documentation for your system and peripherals. 


Conventions 
# A number sign represents the superuser prompt. 
% cat Boldface type in interactive examples indicates typed user input. 
file Italic (slanted) type indicates variable values, placeholders, and function 


argument names. 


cat(1) 


Ctrl/x 
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In syntax definitions, a horizontal ellipsis indicates that the preceding item 
can be repeated one or more times. 


A cross-reference to a reference page includes the appropriate section 
number in parentheses. For example, cat(1) indicates that you can find 
information on the cat command in Section 1 of the reference pages. 


This symbol indicates that you hold down the first named key while 
pressing the key or mouse button that follows the slash. In examples, this 
key combination is enclosed in a box (for example, {Ctrl/C}). 
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On occasion, routine system maintenance may require you to shut down your system. 
The exact shutdown procedure that you use depends on whether you want to shut 
down multiuser mode and remain in single-user mode, shut down and halt the 
processor, or shut down multiuser mode and reboot. This chapter explains all of 
these procedures. 


1.1. Shutting Down Multiuser Mode 


There are three steps for shutting down multiuser mode and staying in single-user 
mode so that you can perform routine system maintenance. Steps 2 and 3 are optional 
and depend on the type of system maintenance that you want to perform. The steps 
are: 


1. Use the shutdown command to bring the system to single-user mode. For 
example: 


# /etc/shutdown +15 ‘to install new devices’ 


This will shut down the system to single-user mode in 15 minutes. The 
shutdown command logs the specified reason (shown within single quotation 
marks (‘’)) in the /usr/adm/shutdownlog file. Then, it notifies current 
users of the impending shutdown. It also creates an /etc/nologin file five 
minutes before the shutdown occurs, to prevent users from logging into the 
system. At the designated time, the shutdown command shuts down multiuser 
mode. 


When the system displays the superuser prompt (#), the system is back to single- 
user mode. The system console is open with the superuser account active. All 
other terminals are disabled, but all file systems are still mounted. You may now 
want to unmount file systems or you may want to halt the processor. 


When you restart multiuser mode, the /etc/rc script automatically removes 
/etc/nologin to reenable user logins. 


2. Unmount file systems. If you want to, you can now unmount the file systems. 
To unmount all file systems, use the umount command with the —a option. You 
must be in the root (/) directory before you issue the umount command. For 
example: 


# cea / 
# /etc/umount —-a 


This command unmounts those file systems named in the /etc/fstab file and 
leaves only the root file system mounted. If you have mounted a file system that 
is not defined in /etc/fstab and you want to unmount it, use the umount 

command and specify the file system’s special device name. You can tell if a file 


system is mounted by typing: 
# /etc/mount 


When specified without options, the mount command displays the currently 
mounted file systems. For example: 
/dev/rz0Oh on /usr/staff type ufs 


/dev/rz2c on /usr/staff/rl type ufs 
sysname:/usr/staff/a2 on /usr/staff/a2 type nfs (rw,soft,bg,nosuid) 


To unmount the /usr/staff file system, use the umount command as shown 
in the following example: 


# /etc/umount /dev/rz0h 


Notice that, to unmount the /usr/staff file system, you must unmount the 
device on which it resides. In this example, /usr/staff resides on the h 
partition of the rzO disk. 


For more information on both the mount and umount commands, refer to 
mount(8) in the ULTRIX Reference Pages. 


3. Halt the system. After you have issued the shutdown command, you can halt 
the system with the halt command. (Depending on your processor type, the 
system will either halt itself, or it will direct you to halt the system.) For 
example: 


# /etc/halt 
syncing disks ... 


° 


>> 


The halt command stops the processor and the console monitor prompt is 
displayed. You can now boot the system to single-user or multiuser mode as 
described in Chapter 2. 


When your system is in single-user mode, you can proceed with the desired 
maintenance procedure. 


1.2 Shutting Down and Halting the System 


To shut down multiuser mode and halt the processor, use the shut down command 
with the —h option specified. For example: 


# /etc/shutdown -h +10 ’scheduled maintenance’ 


This will shut down and halt the processor in 10 minutes. The shutdown command 
logs the specified reason (shown within single quotation marks (’’)) into the 
/usr/adm/shutdownlog file. Then, it notifies current users of the impending 
shutdown. At the specified time, the shutdown command shuts down multiuser 
mode and halts the processor. 


When you restart multiuser mode, the /etc/rc script automatically removes 
/etc/nologin to reenable user logins. 


The halt command provides an alternative shutdown procedure and should only be 
invoked from single-user mode. 
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1.3. Shutting Down and Rebooting the System 


To shut down multiuser mode and immediately reboot the system, use the 
shutdown command with the —r option specified. For example: 


# /etc/shutdown -r +20 ‘doing a quick reboot’ 


This will shut down and reboot the system in 20 minutes. The shutdown command 
logs the specified reason (shown within single quotion marks (’’)) into the 
/usr/adm/shutdownlog file. Then, it notifies current users of the impending 
shutdown. It also creates the /etc/nologin file five minutes before the shutdown 
occurs to prevent users from logging into the system. At the specified time, the 
shutdown command shuts down multiuser mode, updates the file system 
superblocks, halts the processor, and immediately reboots multiuser mode. When 
you restart multiuser mode, the /etc/rc script automatically removes the 
/etc/nologin file to reenable user logins. 


The reboot command provides an alternative startup and shutdown capability but is 
not recommended for normal operations. 


1.4 Shutting Down a Diskless Client 


To shut down a diskless client, use the shut down command at the client processor. 
The shutdown command works the same for diskless clients as it does for any 
processor. However, you should avoid using the shutdown -r command, because 
the default boot device may not be the Ethernet device. 
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During normal operations and after system crashes, you may need to restart or boot 
the system. To boot any system successfully, you must know whether you want the 
system to come up in single-user or multiuser mode. 


This chapter provides information about the available startup modes. It describes 
what happens when you: 


Boot the default device to single-user mode 
e Boot the default device to multiuser mode 
e¢ Boot alternate devices to either single-user or multiuser mode 


e Invoke multiuser mode from single-user mode 


Chapter 3 describes the specific boot commands. 


2.1 Booting the System to Single-User Mode 
When you boot the system to single-user mode: 


e The system comes up with only the root file system mounted. All other file 
systems are unmounted and all configured terminals and networking are disabled. 
You have access only to those files and commands in the root file system, 
unless you explicitly mount other file systems. 


e The Bourne shell (sh) runs at the console under a partially active superuser 
account. Although the sh program has read the .profile file, the Login 
utility has not been invoked, the superuser is not logged in, and a full 
environmental initialization for the superuser account has not occurred. 


e You must invoke the fsck program to check the integrity of the root file 
system. If the £sck program reports inconsistencies in the root file system, 
you must correct them before mounting any other file system. For a description 
of the command and its options, see £sck(8) in the ULTRIX Reference Pages. 
For examples of how and when to use the fsck program to check for and correct 
file system inconsistencies, see the Guide to System Crash Recovery for your 
processor. 


e If you need other file systems mounted, you must invoke the mount command to 
add the file systems. For a description of the command and its options, see 
mount(8) in the ULTRIX Reference Pages. 


2.2 Booting the System to Multiuser Mode 


When you boot the system to multiuser mode, the init program invokes the 
/etc/rc startup script. The contents of this script and the /etc/rc.local script 
determine what happens, but typically: 


The system comes up with the root (/) and any file systems specified in the 
/etc/fstab file mounted. Consequently, you have access to all files and 
commands in the root file system and other mounted file systems. 


All terminals listed in the /etc/ttys file are enabled. Users with accounts in 
the /etc/passwd file can log in to the system. 


The script automatically invokes fsck, which checks root and other file 
systems listed in the /etc/fstab file. 


— If fsck finds no inconsistencies, the /etc/rc script starts multiuser mode. 


— If fsck finds inconsistencies, the system stays in single-user mode, and you 
should run fsck on the file systems with reported inconsistencies. After 
correcting all reported inconsistencies, reinvoke or reboot multiuser mode. 


2.2.1. Invoking Multiuser Mode from Single-User Mode 


To invoke the multiuser mode from single-user without having to reboot, follow 
these steps: 


1. 


2: 
3. 
4 


Go to the root (/) directory. 
Check for any active programs, daemons, or users on any mounted file system. 
If you find any active processes, stop them. 


Unmount all file systems by typing the umount command with the —a option. 
For example: 


# /etc/umount -a 


The umount program checks the /etc/fstab file and unmounts all file 
systems listed except root. 


Type the mount command with no options. The program lists any file systems 
that are still mounted. For example: 
# /etc/mount 


/dev/rz0a on / type ufs 
/dev/rzla on /tmp type ufs 


If any file system besides root is still mounted, type the unmount command 
again. Specify the mounted file system by typing the device and partition on 
which the file system is mounted. For example, to unmount /tmp (as shown in 
the preceding listing), type: 


# /etc/umount /dev/rzla 


If the unmounting is successful, the program responds by listing the root (/) 
file system only. This indicates that all file systems except root are now 
unmounted. 


Check file systems. Use the fsck command to check them for inconsistencies. 
For example, type: 


# /etc/fsck 


When you type fsck without options, the program checks the file systems listed 
in the /etc/fstab file and notifies you of inconsistencies. 


For more information on the command and its options, see fsck(8) in the 
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ULTRIX Reference Pages. For a description of how and when to use the fsck 
program to correct file system inconsistencies, see the Guide to System Crash 
Recovery for your processor. 


8. Exit single-user-mode. After running fsck and correcting any reported 
inconsistencies, type CTRL/D at the console. CTRL/D ends the single-user mode 
session. 


Once single-user mode ends, the system initialization program, init, automatically 
invokes the multiuser start up script, /etc/rc. During execution, /etc/rce 
invokes /etc/rc.local. When these multiuser startup scripts successfully 
complete execution, the system is in multiuser mode. 


Note 


You cannot mount unclean file systems. If you attempt to enter 
multiuser mode with file systems that were not unmounted cleanly or 
were not checked with the fsck command, the system will not enter 
multiuser mode. 


2.2.2 Booting Multiuser Mode from Console Mode 


To boot multiuser mode directly from console mode, enter the multiuser boot 
command that is specific to your processor type. For a description of the processor- 
specific boot commands, see Chapter 3. 


2.2.3. Booting the System in Conversational Mode on VAX Processors 


To boot the system in conversational mode (available only on VAX processors), you 
enter one of the processor-specific boot commands listed in Chapter 3. In any case, 
when you boot in conversational mode, the program prompts you to enter an image 
name. For example: 


Enter image name:vmunix 


We recommend that you load the default kernel; however, you can optionally load 
another. If you take this option, use the following syntax: 


(device, partition) kernel_name 


The first variable, device, specifies the device where the image is located. The 
booted device is the default. The second variable, partition, specifies the 
partition on the device. Partition a of the booted device is the default. The 
kernel_name can be any kernel existing at either the default location or at the 
location you specify. 


Some device and partition syntax rules are: 


e You can specify a single number to define the device number using the default 
partition. For example: (3)vmunix 


e You can specify a single letter from a to h to define the partition using the default 
boot device. For example: (g)vmunix 


e You can specify a number and a letter for the device and partition. For example: 
(3,g)vmunix 
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e You can specify two numbers, the second of which corresponds to a letter from a 
through h for a partition, starting with 0 for a and ending with 7 for h. For 
example: (3,6)vmunix 


The first time you enter invalid input, the boot program displays the message: 


Syntax Error 


Examples of valid input syntax are: 


newvmunix - 
(g) vmunix - 
(3)vmunix.old - 
(9,g) vmunix - 
(4,7) vmunix - 


Loads 
Loads 
Loads 
Loads 
Loads 


newvmunix from the booted device, partition a 
vmunix from the booted device, partition g 
vmunix.old from device unit 3, partition a 
vmunix from device unit 9, partition g 
vmunix from device unit 4, partition h 


Note: If specified, the device unit number must be the PHYSICAL 
unit number of a device connected to the SAME CONTROLLER as the 


booted device. 


If you enter another invalid entry, the boot program simply responds: 


Syntax Error 


Note 


On MSCP-type disk drives, it is possible for the booted drive to go off 
line during a conversational boot. If you do not supply input to the 
Enter image name: prompt within several minutes, the booted 
MSCP drive goes off line and subsequent reads fail. To prevent this 
problem, enter the image name before the timeout period. 
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This chapter provides guidelines for booting your processor. The boot commands 
that you use depend on your processor type and its attached hardware. The following 
sections describe the various commands with the processors grouped by section 
according to their boot commands. Follow the instructions in the section that applies 
to your processor; then continue with Chapter 4. 


3.1 Booting MicroVAX 2000, MicroVAX 3500/3600/3800/3900, 
VAXstation Il, VAXstation II/GPX, VAXstation 
2000/3200/3500, and VAXserver 100/3500/3600/3602 
Processors 


This section describes the boot commands for the following processors: 


The MicroVAX 2000 

The MicroVAX 3500 and MicroVAX 3600 

The MicroVAX 3800 and MicroVAX 3900 

The VAXstation II 

The VAXstation II/GPX 

The VAXstation 2000 

The VAXstation 3200 and VAXstation 3500 

The VAXserver 100 

The VAXserver 3500, VAXserver 3600, and VAXserver 3602 


3.1.1 Booting from the Console 


Follow these steps to boot your processor from the console: 


1. 


Release the HALT button on your processor. See your Owner’s Manual for the 
location of the HALT button. 


Boot the default system disk by typing: 


>>>b 


The console program attempts to boot the first device it finds that contains a valid 
boot block. The program first searches diskette devices, other removable disks 
(such as the RA60), for example, and the Winchester devices. Winchester 
devices are searched from lowest to highest unit number. Removable disks have a 
higher priority than Winchester devices, regardless of unit number. 


3. Decide which startup mode you want, and then type the corresponding entry at 
the prompt. For example: 


Mode Prompt and Entry 
Single-user >>> b/2 duan 
Multiuser >>> b duan 
Conversational >>> b/3 duan 
(single-user mode) 

Conversational >>> b/1 duan 


(multiuser mode) 


The variable n specifies the device number of the system disk drive. For 
example, to boot vmunix (the kernel image) to single-user mode from RD53 
drive 1 on a MicroVAX II, type: 


>>>b/2 dual 


See Chapter 2 for additional information on startup modes. 


3.1.2 Booting from a TK50 Tape 


When doing an installation or booting the standalone kernel for system management 
tasks, you may have to boot from a TKSO tape. After installing the TK50 boot tape, 


type: 


>>>b muad 


In response to this entry, the console subsystem boots the TK50 boot tape. 


3.1.3. Booting from the Network 
You must boot from the network to perform any of the following operations: 
e Booting a diskless system 
e Initiating an installation from a remote server 
e Booting a standalone kernel from a remote server, in order to perform system 


management tasks 


The boot command that you choose depends upon the type of processor you have. If 
you are booting the MicroVAX II, the VAXstation II, the VAXstation II/GPX, the 
VAXstation 3200, the VAXstation 3500, a MicroVAX 3000 series processor, a 
VAXserver 100, or a VAXserver 3000 series processor, type: 


>>>b xqa0 


e If you are booting the MicroVAX 2000 or the VAXstation 2000 from the 
network, type: 


>>>b esa 


In response to your entry, the console subsystem boots the system and displays the 
memory and hardware configuration. 
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3.2 Booting MicroVAX 3300 and MicroVAX 3400 Processors 


The following sections describe how to boot these processors from the console or the 
network. 


3.2.1. Booting from the Console 


Follow these steps to boot your processor from the console: 


1. 


Release the HALT button on your processor. See your Owner’s Manual for the 
location of the HALT button. 


. Identify which device (if any) was set as the default by typing: 


>>>show boot 


The console program responds with the device name. For example: 


>>>show boot 
DIAO 


Boot the default system disk by typing: 


>>>b 


The console program boots the default device and displays the device name. For 
example: 


>>>b 
(BOOT/R5:0 DIAO) 


Decide which startup mode you want, and then type the corresponding entry at 
the prompt. For example: 


Mode Prompt and Entry 
Single-user >>> b/2 dian 
Multiuser >>> b dian 
Conversational >>> b/3 dian 
(single-user mode) 

Conversational >>> b/1 dian 


(multiuser mode) 


The variable n specifies the device number of the system disk drive. For 
example, to boot vmunix (the kernel image) to single-user mode from drive 1 on 
a MicroVAX 3400, type: 


>>>b/2 dial 


See Chapter 2 for additional information on startup modes. 


3.2.2 Booting from the Network 


You must boot from the network to perform any of the following operations: 


Booting a diskless system 
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e Initiating an installation from a remote server 
e Booting a standalone kernel from a remote server, in order to perform system 
management tasks 


To boot the system from the network, use the following command: 


>>>b esa 


In response to your entry, the console subsystem boots the system and displays the 
memory and hardware configuration. 


3.3 Booting VAXstation 3100, Micro VAX 3100, and VAXserver 
3100 Processors 


Your choice of a boot command for a VAXstation 3100, Micro VAX 3100, or 
VAXserver 3100 depends on your hardware configuration. The following sections 
describe the various boot commands. 


3.3.1. Booting from the Console 


Follow these steps to boot your processor from the console: 


1. Press the HALT button on your processor. See your Owner’s Manual for the 
location of the HALT button. 


2. Find out which device (if any) was set as the default by typing: 


>>>show boot 


— Ifa default device was set, the console program responds with the name of 
the default device. For example: 


>>>show boot 
DKA300 


— Ifno default device was set, the console program responds as follows: 


>>>show boot 


3. Get a boot device listing by typing: 


>>>show device 


The console program displays a device listing similar to this: 


VMS /VMB ULTRIX ADDR DEVTYP NUMBYTES RM/FX WP DEVNAME 
ESAQ SEO 08-00-2B-07-05-09 

DKA300 R223 A/3/0/00 DISK 06407E00 FX R223 
MKA500 TZ25 A/5/0/00 TAPE severe sideisie RM 

HostID A/6 INITR 

DKB100 R29 B/1/0/00 DISK 1383B200 FX R255 
DKB200 RZ10 B/2/0/00 RDDISK 06407E00 RM R223 
DKB300 RZ11 B/3/0/00 RDDISK 06407E00 RM R223 
DKB400 R212 B/4/0/00 DISK 0C3B1600 RM RRD40 
MKB500 T213 B/5/0/00 TAPE Neck tenetiectee. ai RM 

Host ID B/6 INITR 
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In the preceding display: 


— Column | lists the boot command name associated with a particular device 
configured at a specific address. 


— Column 2 lists the ULTRIX device mnemonic and number associated with a 
particular device type. 


— Column 3 lists the address of the specific device. The first character specifies 
the SCSI controller identification (either A or B). The second character 
specifies the SCSI bus identification number. The remaining characters are 
always zeroes. 


~— Column 4 lists the device types. 
— Column 5 lists internal addressing information needed by the system. 


— Column 6 lists mnemonics that indicate whether the device is fixed or 
removable. 


— Column 7 lists the physical device name. 


Boot the default system device by typing: 


>>>b 


% 


The console program boots the default device. However, if no default device was 
set previously, the console defaults to a network boot. 


Boot a specific device using the following format: 
b boot device name 


For example, assume you wanted to boot an RZ23 fixed disk at SCSI controller 
A, SCSI bus 3. To boot this device, type: 


>>>b DKA300 


Note 


The console program is not case-sensitive when accepting boot 
commands for the VAXstation 3100 processor. Consequently, you 
can use either uppercase or lowercase letters when typing the boot 
command name. 


. Decide which startup mode you want and then type the corresponding entry at the 
prompt. 


— If you are booting a disk device at SCSI controller A, use the following list to 
determine the correct entry: 


Mode Prompt and Entry 
Single-user >>> b/2 dkan 
Multiuser >>> b dkan 
Conversational >>> b/3 dkan 
(single-user mode) 

Conversational >>> b/1 dkan 


(multiuser mode) 


The variable n specifies the SCSI bus identification number of the system 
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disk drive. For example, to boot vmunix (the kernel image) to single-user 
mode from the system disk at SCSI bus ID 3, type: 


>>>b/2 dka300 


To boot vmunix (the kernel image) to multiuser mode from the system disk 
at SCSI bus ID 2, type: 


>>>b dka200 


If you are booting a disk device at SCSI controller B, use the following list to 
determine the correct entry: 


Mode Prompt and Entry 
Single-user >>> b/2 dkbn 
Multiuser >>> b dkbn 
Conversational >>> b/3 dkbn 
(single-user mode) 

Conversational >>> b/1 dkbn 


(multiuser mode) 


The variable n specifies the SCSI bus identification number of the system 
disk drive. For example, to boot vmunix (the kernel image) to single-user 
mode from the system disk at SCSI bus ID 3, type: 


>>>b/2 dkb300 

To boot vmunix (the kernel image) to multiuser mode from SCSI bus ID 2, 
type: 

>>>b dkb200 


See Chapter 2 for additional information on startup modes. 


3.3.2 Booting from a TZ30 or TZK50 Tape 


When doing an installation or booting the standalone kernel for system management 
tasks, you may have to boot from tape. After installing the boot tape, use one of the 
following boot commands: 


If you are booting from tape at SCSI controller A, use the following format: 
b mkan 


The variable n specifies the SCSI bus identification number of the system tape. 
For example, to boot from tape at SCSI controller A, SCSI bus ID 3, type: 


>>>b mka300 


In response to this entry, the console subsystem boots the boot tape. 


If you are booting from tape at SCSI controller B, use this syntax: 
b mkbn 


The variable n specifies the SCSI bus identification number of the system tape. 
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For example, to boot from tape at SCSI controller B, SCSI bus ID 3, type: 
>>>b mkb300 


3.3.3 Booting from the Network 


You must boot from the network to perfom any of the following operations: 


Booting a diskless system 
Initiating an installation from a remote server 


Booting a standalone kernel from a remote server, in order to perform system 
management tasks 


To boot the system from the network, use the following command: 


>>>b eas0 


In response to your entry, the console subsystem boots the system and displays the 
memory and hardware configuration. 


3.4 Booting a VAXstation 3520 or a VAXstation 3540 


Your choice of a boot command for a VAXstation 3520 or 3540 depends on your 
hardware configuration. The following sections describe the various boot commands. 


3.4.1. Booting from the Console 


Follow these steps to boot your processor from the console: 


1. 


2. 


Release the HALT button on your processor. See your Owner’s Manual for the 
location of the HALT button. . 


Find out which device (if any) was set as the default by typing: 


>>>show boot 


If a default device was set, the console program responds with the name of the 
default device. For example: 


>>>show boot 
DKA100 


If no default device was set, the console program responds as follows: 


>>>show boot 


Get a boot device listing by typing: 


>>>show scsi 
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The console program displays a device listing similar to this: 


ADDR VMB DEVTYP DEVNAM NUMBYTS REV CHAR 
5.0.0 DKAO DISK RZ55 332 MB 0700 
5.1.0 DKA100 DISK R255 332 MB 0700 
5.4.0 DKA400 DISK R255 332 MB 0700 
5.6.0 DKA600 RODISK RRD40 599 MB 250D 
Ded. HOST SII-A RM, WP 


In the preceding display: 
— Column 1 lists internal addressing needed by the system 


— Column 2 lists the VMS device mnemonic and number associated with a 
particular device type. 


— Column 3 lists the device type. 

— Column 4 lists the device name. 

— Column 5 lists the number of bytes on the media. 
— Column 6 lists the device microcode. 


4. Boot the default system device by typing: 


>>>b 


The console program boots the default device. However, if a default device was 
not set, the boot will fail with the following error message: 


? 4ONOSUCHDEV 


5. Boot a specific device by typing: 
>>> b boot_device_name 


For example, to boot an RZ55 fixed disk at SCSI bus ID 1, type: 
>>>b DKA100 


Note 


The console program is not case sensitive when accepting boot 
commands for the VAXstation 3520 processor. Consequently, you 
can use either uppercase or lowercase letters when typing the boot 
command name. 


6. Decide which startup mode you want and then type the corresponding entry at the 
prompt. Use the following list to determine the correct entry: 


Mode Prompt and Entry 
Single-user >>> b/2 dkan 
Multiuser >>> b dkan 
Conversational >>> b/3 dkan 
(single-user mode) 

Conversational >>> b/1 dkan 


(multiuser mode) 
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The variable n specifies the SCSI bus identification number of the system disk 
drive. For example, to boot vmunix (the kernel image) to single-user mode 
from the system disk at SCSI bus ID 3, type: 


>>>b/2 dka300 


To boot vmunix (the kernel image) to multiuser mode from the system disk at 
SCSI bus ID 2, type: 


>>>b dka200 


See Chapter 2 for additional information on startup modes. 


3.4.2 Booting a TK50 Tape 
When doing an installation or booting the standalone kernel for system management 
tasks, you may have to boot from a TK50 tape. After installing the TK50 boot tape, 
type: 


>>>b muad 


In response to this entry, the console susbystem boots the TK50 boot tape. 


3.5 Booting a VAX-11/750 


Your choice of a boot command for a VAX-11/750 depends on your hardware 
configuration. The following sections describe the boot commands for both local 
disks and remote disks connected to an HSC. 


3.5.1. Booting a Local Disk 


The following list describes the boot commands for local disks: 


To boot the default system disk to multiuser mode, type: 


>>>b 


To boot the system disk to single-user mode, type: 
>>>b/3 


The console subsystem reads the askboo.cmd file, boots the default system 
disk, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


To boot an alternate disk, use one of the commands listed in the following table. 
Be aware that RPO7 drives are not supported as boot devices. 


Conversational Conversational 


Drive Type Single-user Multiuser Single-User Multiuser 
RAxx Disk b/2 duan b duan b duan b/1 duan 
RPO05/06 and b/2 dban b dban b/3 dban b/1 dban 
RMO03/05/80 Disks 


The variable xx is the model number of the system disk drive and the variable 
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n represents the unit number of the system disk drive. For example, to boot 
multiuser mode from an RM05 system disk, unit number one, type: 


>>>b dbal 


See Chapter 2 for information on each of the startup modes. 


3.5.2 Booting an HSC Disk 


On a VAX-11/750 processor, the system must load CI microcode contained on the 

console cassette. Therefore, you must ensure that a valid console cassette is in the 

TUS58 drive and that your selector switch is at the cassette setting before attempting 
to boot an HSC disk. 


The console cassette contains the boot command procedure files that enable the 
system to boot the default and alternate disks. The boot command procedure files 
are: 


¢ askboo.cmd, which boots the default disk to single-user mode 
e defboo.cmd, which boots the default disk to multiuser mode 


¢ cira.cmd, which boots an alternate disk to single-user or multiuser mode 


When the CI microcode is loaded, the software can boot either the default or an 
alternate HSC disk to a particular startup mode. The following list describes the boot 
commands: 

e To boot the default HSC system disk to multiuser mode, type: 


>>>b 


The console subsystem reads the defboo.cmd file, boots the default system 
device, and brings the system up in multiuser mode. 
e To boot the default HSC system disk to single-user mode, use this format: 


>>>b/800 ddad 
BOOTS8> @askboo.cmd 


The console subsystem reads the askboo.cmd file, boots the default system 
device, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 
e To boot an alternate HSC disk, use this format: 


>>> b/800 ddad 
BOOT58> D/G 2 HSC# 
BOOT58> D/G 3 unit# 
BOOT58> @cira.cmd 


The HSC# is the remote CI port number assigned to the specific HSC controller. 
The unit # variable is the device number of the system disk drive. The 
@cira.cmd string invokes the HSC boot command file. 
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Note 


Both the HSC number and the unit number must be expressed in 
hexadecimal. 


The console subsystem reads the cira.cmd file, boots the alternate system 
device, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.6 Booting a VAX-11/780 or a VAX-11/785 


Your choice of a boot command for a VAX-11/780 or a VAX-11/785 depends on 
your hardware configuration. The following sections describe the boot commands for 
both local disks and remote disks connected to an HSC. 


Note 


The descriptions in this section assume that the front-end console storage 
device has been updated to reflect the proper default boot device. Refer 
to Section 3.10 for information on how to do this. 


3.6.1 Booting a Loca! Disk 


The VAX-11/780 and VAX-11/785 processors have front-end console storage devices 
that contain boot command procedure files. The command procedure files that enable 
you to boot the default and alternate disks are: 


defboo.cmd, which boots the default disk to multiuser mode 
askboo.cmd, which boots the default disk to single mode 
mbahp.cmd, which boots an alternate MASSBUS disk to single-user mode 


ubara.cmd, which boots an alternate UNIBUS disk connected to a UDA-50 
controller to single-user mode 


The following list describes the boot commands: 


To boot the default system disk to multiuser mode, type: 


>>>b 


The console subsystem reads the defboo.cmd file, boots the default system 
disk, and brings the system up in multiuser mode. 


To boot the default system disk to single-user mode, type: 


>>>b ask 


The console subsystem reads the askboo.cmd file, boots the default system 
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disk, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 
e To boot an alternate MASSBUS disk to single-user mode, use this format: 


>>> dri TR# 
>>> dr3 unit# 
>>> @mbahp.cmd 


The TR# variable is the TR level number of the MASSBUS adapter. The unit# 
variable is the device number of the system disk drive. The @mbahp. cmd string 
invokes the MASSBUS adapter boot command file. 

Note 


Both the TR level number and the unit number must be expressed in 
hexadecimal. 


The console subsystem reads the mbahp.cmd file, boots the alternate system 
disk, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


e¢ To boot an alternate UNIBUS disk connected to a UDA-50 controller to single- 
user mode, use this format: 


>>> dri TR# 
>>> dr3 unit# 
>>> @ubara.cmd 


The TR# variable is the TR level number of the UNIBUS adapter. The unit# 
variable is the device number of the system disk drive. The @ubara.cmd string 
invokes the UNIBUS adapter boot command file. 


Note 


Both the TR level number and the unit number must be expressed in 
hexadecimal. 


The console subsystem reads the ubara.cmd File, boots the alternate system 
disk, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.6.2 Booting an HSC Disk 


The VAX-11/780 and VAX-11/785 processors have front-end console storage devices 
that contain boot command procedure files. The command procedure files that enable 
you to boot the default and alternate HSC disks are: 
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e defboo.cmd, which boots the default disk to multiuser mode 
e askboo.cmd, which boots the default disk to single-user mode 


® cira.cmd, which boots an alternate disk to single-user mode 


The following list describes the boot commands: 


¢ To boot the default system disk to multiuser mode, type: 


>>>b 
The console subsystem reads the defboo.cmd file, boots the default system 
disk, and brings the system up in multiuser mode. 


e To boot the default system disk to single-user mode, type: 


>>>b ask 
The console subsystem reads the askboo.cmd file, boots the default system 
disk, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 
e To boot an alternate HSC disk to single-user mode, use this format: 


>>> dr2 HSC# 
>>> dr3 unit# 
>>> @cira.cmd 


The HSC# variable is the remote CI port number assigned to the specific HSC 
controller. The unit # variable is the device number of the system disk drive. 
The @cira.cmd string invokes the HSC boot command file. 


Note 


Both the HSC number and the unit number must be expressed in 
hexadecimal. 


The console subsystem reads the cira.cmd file, boots the alternate system disk, 
and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.7 Booting a VAX 6210/6220/6230/6240, VAX 
631 0/6320/6330/6340/6350/6360, or a VAX 6000-series 
This section describes the boot commands for the following processors: 
¢ VAX 6220/6230/6240 
¢ VAX 6310/6320/6330/6340/6350/6360 
e VAX 6000-410/420/430/440/450/460 


Your choice of a boot command for these processors depends on your hardware 
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configuration. The following sections describe the boot commands for both local 
disks and remote disks connected to an HSC. 


3.7.1. Booting a Local Disk 


The following list describes the boot commands for local disks: 


To boot the default system disk to multiuser mode, type: 


>>>b 


To boot the system disk to single-user mode, type: 

>>>b ask 

The console subsystem reads the askboo.cmd file, boots the default system 
disk, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 
To boot an alternate disk, type: 
>>> b/xmi:B/A# /bi: B/# /r5:1000b duunit# 


The BIA# variable represents the number (0,1,2, or 3) of the BI adapter 
connected to the xmi. The BI# variable represents the BI node number of the 
xmi adapter. The unit # variable represents the device number of the system 
disk drive. 

Note 


The BIA number, the BI number, and the unit number must be 
expressed in hexadecimal. 


The console subsystem boots the alternate system device and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.7.2 Booting an HSC Disk 


On a VAX 6210 or a VAX 6220 processor, the system must load CI microcode 
contained on the TKSO cartridge. Therefore, you must ensure that a valid cartridge is 
in the TK5O drive before attempting to boot an HSC disk. See your Field Services 
representative for details on the correct procedure. 


The following list describes the boot commands: 


To boot the default HSC system disk to multiuser mode, type: 


>>>b 


The console subsystem reads the defboo.cmd file, boots the default system 
device, and brings the system up in multiuser mode. 
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e To boot the default HSC system disk to single-user mode, type: 


>>>b ask 


The console subsystem reads the askboo.cmd file, boots the default system 
device, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


¢ To boot an alternate HSC disk, type: 
>>> b /xmi: BIA# /bi: B/# /node: HSC# /r5:1000b duunit# 


The BIA# variable represents the number (0, 1, 2, or 3) of the BI adapter 
connected to the xmi. The BI# variable represents the BI node number of the 
xmi adapter. The HSC# represents the remote CI port number assigned to the 
specific HSC controller. The du unit #variable represents the device number of 
the system disk drive. 

Note 


The BIA number, the BI number, the HSC number, and the unit 
number must be expressed in hexadecimal. 


The console subsystem boots the alternate system device, and displays the 
prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.8 Booting a VAX 8200, VAX 8250, VAX 8300 or a VAX 8350 


On a VAX 8200, 8250, 8300, or 8350, the boot command you use depends on your 
hardware configuration. The following sections describe the boot commands for both 
local disks and remote disks connected to an HSC. 


Note 


The descriptions in this section assume that the EEPROMs have been 
reprogrammed to reflect the proper default boot device. Refer to Section 
3.11 for information on how to do this. 


3.8.1. Booting a Local Disk 


On any of these processors, the default boot command boots the default device 
described in the EEPROM of the processor. Programming the EEPROM is described 
in the VAX Owner’s Manual. 
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The following list describes the boot commands that you use to boot local disks: 


To boot the default system disk to multiuser mode, type: 


>>>b 
The console subsystem boots the default system disk and brings the system up in 
multiuser mode. 


To boot the default system disk to single-user mode, type: 
>>>b/xr5:3 


The console subsystem boots the default system disk, brings the system up in 
single-user mode, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


To boot an alternate disk, use one of the commands listed in the following table. 


Mode Prompt and Entry 
Single-user >>> b/r5:2 duBl#n 
Multiuser >>> b duBl#n 
Conversational >>> b/r5:3 duBl#n 
(In single-user mode) 

Conversational >>> b/r5:1 duBl#n 


(In multiuser mode) 


The BI# variable represents the BI node number and the n variable represents the 
unit number of the desired boot device. For example, to boot in conversational 
mode (assuming a BI node number of 4 and a unit number of 0), type: 


>>>b/r5:3 du40 


The system comes up in conversational mode, signified by the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.8.2 Booting an HSC Disk 


On any of these processors, the default boot command boots the default device 
described in the EEPROM of the processor. Programming the EEPROM is described 
in the VAX Owner’s Manual. 


The following list describes the boot commands that you use to boot the default and 
alternate disks: 


To boot the default system disk to multiuser mode, type: 


>>>b 


The console subsystem boots the default system disk and brings the system up in 
multiuser mode. 
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e To boot the default system disk to single-user mode, use this format: 


>>>b/r5:800 
BOOTS8> @askboo.cmd 


The console subsystem reads the askboo.cmd file, boots the default system 
disk, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 
e To boot an alternate HSC disk, use this format: 


>>> b/r5:800 csal 
BOOT58> D/G 1 Bi# 
BOOT58> D/G 2 HSC# 
BOOT58> D/G 3 unit# 
BOOT58> @cira.cmd 


The BI# variable represents the BI node number of the CI adapter. The HSC# 
variable represents the remote CI port number assigned to the specific HSC 
controller. The unit# variable represents the device number of the system disk 
drive. The @cira.cmd string invokes the HSC boot command file. 

Note 


The BI number, the HSC number, and the unit number must be 
expressed in hexadecimal. 


The console subsystem reads the cira.cmd file, boots the alternate system 
device, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.9 Booting a VAX 8500, VAX 8530, VAX 8550, VAX 8700, VAX 


3.9.1 


8800, or a VAX 8810 


On a VAX 8500, 8530, 8550, 8700, 8800, or 8810, the boot command you use 
depends on your hardware configuration. The following sections describe the boot 
commands for both local disks and remote disks connected to an HSC. 


Note 


The descriptions in this section assume that the front-end console storage 
device has been updated to reflect the proper default boot device. Refer 
to Section 3.11 for information on how to do this. 


Booting a Local Disk 


All of these processors have front-end console storage devices that contain boot 
command procedure files. The command procedure files that enable you to boot the 
default and alternate disks are: 
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e defboo.com, which boots the default system disk to multiuser mode 

e askboo.com, which boots the default system disk to single-user mode 

¢ bdara.com, which boots an alternate disk to single-user mode if the BI adapter 
is a KDB50 

The following list describes the boot procedures for the various disks and modes: 


e To boot the default system device to multiuser mode, type: 


>>>b 


The console subsystem reads the defboo.com file, boots the default system 
device, and brings the system up in multiuser mode. 


e To boot the default system device to single-user mode, type: 


>>>b ask 


The console subsystem reads the askboo.com file, boots the default system 
disk, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


e To boot an alternate disk (where the BI adapter is a KDBSO) to single-user mode, 
use the format: 


>>> dri BIA#FBIF# 
>>> dr3 unit# 
>>> @bdara.com 


The BIA# variable represents the number of the BI adapter (0, 1, 2, or 3) 
connected to the KDBS0. The BI# variable represents the BI node number of the 
KDB50 adapter. The unit # variable is the device number of the system disk 
drive. The @bdara.com string invokes the KDB50 boot command file. 

Note 


The BI adapter number, the BI node number, and the unit number 
must be expressed in hexadecimal. 


The console subsystem reads the bdara.com file, boots the alternate system 
disk, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.9.2 Booting an HSC Disk 


All of these processors have front-end console storage devices that contain boot 
command procedure files. The command procedure files that enable you to boot the 
default and alternate disks are: 


e defboo.com, which boots the default system disk to multiuser mode 


3-18 Processor-Specific Boot Commands 


e askboo.com, which boots the default system disk to single-user mode 


¢ bcira.com, which boots an alternate disk to single-user mode if the BI adapter 
isa BCA 


The following list describes the boot commands for the various disks and modes: 


¢ To boot the default system disk to multiuser mode, type: 


>>>b 


The console subsystem reads the defboo.com file, boots the default system 
device, and brings the system up in multiuser mode. 


¢ To boot the default system disk to conversational mode, type: 


>>>b ask 


The console subsystem reads the askboo.com file, boots the default system 
device, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


e¢ To boot an alternate HSC disk to single-user mode when the CI adapter is a 
BCA, use the format: 


>>> dri BIA#BI# 
>>> dr2 HSC# 
>>> dr3 unit# 
>>> @bcira.com 


The BIA# variable represents the number (0, 1, 2, or 3) of the BI adapter 
connected to the CI adapter. The BI# variable represents the BI node number of 
the CI adapter. The HSC# variable represents the remote CI port number 
assigned to the specific HSC controller. The unit # variable is the device 
number of the system disk drive. The @bcira.com string invokes the HSC 
boot command procedure file. 


Note 


The BI adapter number, the BI node number, the HSC number, and 
the unit number must be expressed in hexadecimal. 


The console subsystem reads the bcira.com file, boots the alternate HSC disk, 
and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.10 Booting a VAX 8820/8830/8840 


On a VAX 8820/8830/8840 processor, the boot command you use depends on your 
hardware configuration. The following sections describe the boot commands for both 
local disks and remote disks connected to an HSC. 
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3.10.1 Booting a Local Disk 


All of these processors have front-end console storage devices that contain boot 
command procedure files. The command procedure files that enable you to boot the 
default and alternate disks are: 


e defboo.cmd, which boots the default system disk to multiuser mode 

¢ askboo.cmd, which boots the default system disk to single-user mode 

e bdara.cmd, which boots an alternate disk to single-user mode if the BI adapter 
is a KDB50 

The following list describes the boot procedures for the various disks and modes: 


e¢ To boot the default system device to multiuser mode, type: 


>>>b 


The console subsystem reads the defboo.cmd file, boots the default system 
device, and brings the system up in multiuser mode. 


e To boot the default system device to single-user mode, type: 


>>>b ask 


The console subsystem reads the askboo.cmd file, boots the default system 
disk, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


¢ To boot an alternate disk (where the BI adapter is a KDB50) to single-user mode, 
use the format: 


>>> dri BIA#BIF 
>>> dr3 unit# 
>>> @bdara.cmd 


The BIA# variable represents the number of the BI adapter (0, 1, 2, 3, 4, or 5) 
connected to the KDBS0. The BI# variable represents the BI node number of the 
KDBS0 adapter. The unit# variable is the device number of the system disk 
drive. The @bdara.cmd string invokes the KDB50 boot command file. 

Note 


The BI adapter number, the BI node number, and the unit number 
must be expressed in hexadecimal. 


The console subsystem reads the bdara.cmd file, boots the alternate system 
disk, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 
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3.10.2 Booting an HSC Disk 


All of these processors have front-end console storage devices that contain boot 
command procedure files. The command procedure files that enable you to boot the 
default and alternate disks are: 


¢ defboo.cmd, which boots the default system disk to multiuser mode 
e¢ askboo.cmd, which boots the default system disk to single-user mode 


¢ bcara.cmd, which boots an alternate disk to single-user mode if the BI adapter 
is a BCA 


The following list describes the boot commands for the various disks and modes: 


e To boot the default system disk to multiuser mode, type: 


>>>b 


The console subsystem reads the defboo.cmd file, boots the default system 
device, and brings the system up in multiuser mode. 


¢ To boot the default system disk to conversational mode, type: 


>>>b ask 


The console subsystem reads the askboo.cmd file, boots the default system 
device, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


¢ To boot an alternate HSC disk to single-user mode when the CI adapter is a 
BCA, use the format: 


>>> dri BIA#BI# 
>>> d r2 HSC# 
>>> dr3 unit# 
>>> @bcara.cmd 


The BIA# variable represents the number (0, 1, 2, 3, 4, or 5) of the BI adapter 
connected to the CI adapter. The BI# variable represents the BI node number of 
the CI adapter. The HSC# variable represents the remote CI port number 
assigned to the specific HSC controller. The unit # variable is the device 
number of the system disk drive. The @bcara.cmd string invokes the HSC 
boot command procedure file. 


Note 
The BI adapter number, the BI node number, the HSC number, and 
the unit number must be expressed in hexadecimal. 


The console subsystem reads the bcara.cmd file, boots the alternate HSC disk, 
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and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.11 Booting a VAX 8600 or a VAX 8650 


On a VAX 8600 or VAX 8650, the boot command you use depends on your 
hardware configuration. The following sections describe the boot commands for both 
local disks and remote disks connected to an HSC. 


3.11.1 Booting a Local Disk 


Both of these processors have front-end console storage devices that contain boot 
command procedure files. These files enable you to boot the default and alternate 
disks. They are: 


¢ defboo.com, which boots the default system device to multiuser mode 

¢ askboo.com, which boots the default system device to single-user mode 

e mbahp.com, which boots an alternate MASSBUS disk to single-user mode 

® ubara.com, which boots an alternate UNIBUS disk connected to a UDA-50 
controller to single-user mode 

The following list describes the boot procedures for the various disks and modes: 


e¢ To boot the default system disk to multiuser mode, type: 


>>>b 


The console subsystem reads the defboo.com file, boots the default system 
device, and brings the system up in multiuser mode. 
e To boot the default system device to single-user mode, type: 


>>>b ask 


The console subsystem reads the askboo.com file, boots the default system 
device, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the Kernel. 


e To boot an alternate MASSBUS disk to single-user mode, use this format: 


>>> dri SBIFTR# 
>>> dr3 unit# 
>>> @mbahp.com 


The SBI# variable represents the Synchronous Backplane Interconnect I/O 
adapter number (either 0 or 1). The TR# variable represents the TR level number 
of the MASSBUS adapter. The unit # variable is the device number of the 
system disk drive. The @mbahp.com string invokes the MASSBUS boot 
command procedure file. 


3—22 Processor-Specific Boot Commands 


Note 


The SBI number, TR level number, and the unit number must be 
expressed in hexadecimal. 


The console subsystem reads the mbahp.com file, boots the alternate disk to 
single-user mode, and displays this prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


To boot an alternate UNIBUS disk connected to a UDA-S0 controller to single- 
user mode, use this format: 


>>> dri SBIFTR# 
>>> dr3 unit# 
>>> @ubara.com 


The SBI# variable represents the SBI I/O adapter number (either 0 or 1). The 
TR# variable represents the TR level number of UNIBUS adapter. The unit # 
variable represents the device number of the system disk drive. The 
@ubara.com string invokes the UNIBUS boot command procedure file. 

Note 


The SBI number, the TR level number, and the unit number must be 
expressed in hexadecimal. 


The console subsystem reads the ubara.com file, boots the alternate disk to 
single-user mode, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.11.2 Booting an HSC Disk 


The VAX 8600 and VAX 8650 processors have front-end console storage devices 
that contain boot command procedure files. The command procedure files that enable 
you to boot the default and alternate HSC disks are: 


defboo.com which boots the default system disk to multiuser mode 
askboo.com which boots the default system disk to single-user mode 


cira.com which boots an alternate system disk to single-user mode 


The following list describes the boot commands for the various disks and modes. 


To boot the default system disk to multiuser mode, type: 


>>>b 


The console subsystem reads the defboo.cmd file, boots the default system 
device, and brings the system up in multiuser mode. 
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To boot the default system device to conversational mode, type: 


>>>b ask 


The console subsystem reads the askboo.cmd file, boots the default system 
device, and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


To boot an alternate HSC disk to single-user mode, use this format: 


>>> dri SBIFTR# 
>>> d r2 HSC# 
>>> dr3 unit# 
>>> @cira.com 


The SBI# variable represents the Synchronous Backplane Interconnect I/O 
adapter number (either 0 or 1). The TR# variable represents the TR level number 
of the CI adapter. The HSC# variable represents the remote CI port number 
assigned to the specific HSC controller. The unit # variable represents the 
device number of the system disk drive. The @cira.com string invokes the 
HSC boot command procedure file. 


Note 


The SBI number, the TR number, the HSC number, and the unit 
number must be expressed in hexadecimal. 


The console subsystem reads the cira.com file, boots the alternate HSC disk, 
and displays the prompt: 


Enter image name: 


In response to this prompt, enter the name of the kernel. 


3.12 Building and Updating Boot Command Files 


This section describes how you can build or update processor-specific boot command 
files. You have to build or update the processor-specific boot command files when 
you want to change the boot default system disk permanently. Some of the processors 
require you to build new boot command files, while others require you to update 
existing boot command files: 


The processors that require you to build new command files are the VAX-11/750, 
VAX 11/780, VAX 11/785, VAX 8600, and VAX 8650 processors. 


The processors that require you to update the existing boot command files are the 
VAX 6210, VAX 6220, VAX 8200, VAX 8500, VAX 8540, VAX 8550, VAX 
8700, VAX 8800, and VAX 8810 processors. 


The following sections contain the procedures for either building or updating a 
processor-specific, bootable console medium. The medium contains the necessary 
hardware support files and the command procedure files for booting the operating 
system. 
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3.12.1 


3.12.2 


Note 


In some cases, the procedures require you to use the file editor, EDT. 
While some EDT commands are provided, you should have the 
appropriate Console Operator’s Guide available for further EDT 
reference information. 


Building a VAX-11/750 Console Cassette 


In general, you do not need to build a new console cassette for a VAX-11/750. 
However, if your hardware supports an HSC configuration, you must build a new 
cassette to enable the HSC remote boot commands. 


To build the cassette, follow these steps: 


1. Invoke the mkconsole program by typing: 
# etc/mkconsole 


The program assumes that /vmunix is the running kernel. When you run the 


program, mkconsole prompts you to remove any cassette from the drive and 
insert a blank cassette. 


2. Replace the original console cassette with a blank cassette, and press the 
RETURN key. The program responds with a brief message to explain its 
activity. At completion, the system prompt appears. 


After building the new cassette, your system is able to boot a remote HSC device. 


Building a VAX—11/780 or a VAX—11/785 Console Diskette 


The procedure in this section describes how to build a boot command file that boots 
the current running system disk. The procedure assumes that the /usr file system is 
mounted. 


During the creation of a bootable diskette, you may have to edit the boot command 
file to set either the memory starting addresses or to set interleaving if you have 
multiple memory controllers. Therefore, a brief description of the contents of the 
boot command file is also included in this section. 


For either the VAX—11/780 or VAX—11/785 processors, there are several boot 
command files that you can use to start your system. The format of these command 
files is the same. Each one contains setup and initialization commands, several 
DEPOSIT statements, and several startup statements. 


The DEPOSIT statements set the RO through R5 General Purpose Registers (GPRs). 
These GPRs are evaluated by the Virtual Memory Bootstrap program VMB. EXE, to 
determine which device is to be booted. All DEPOSIT statements require 
hexadecimal values. 


The GPRs and their meanings are: 

e RO -— Boot device type code 

e R1 — Processor-specific adapter information 
e R2-— Controller number 


e R3-—- Unit number of the boot device 
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e R4- Logical boot block number 


e R5-— Boot control flags 


Appendix B contains a complete listing of the values for each of these registers. 


Example 3-1 shows a sample boot command file (defboo.cmd) for a VAX—11/780 
processor. 


Example 3-1: Sample VAX-11/780 Boot Command File 


. 
. 
. 
. 


{ 
HALT 
UNJAM 
INIT 


DEPOSIT/I 11 20003800 


DEPOSIT 
DEPOSIT 
DEPOSIT 
DEPOSIT 
DEPOSIT 
DEPOSIT 
DEPOSIT 


RO 
R1 
R2 
R3 
R4 
R5 
FP 


iL 
3 
3F468 
0 


10008 
0 


START 20003000 
WAIT DONE 


EXAMINE 


SP 


LOAD VMB.EXE/START:@ 


START @ 


! 
f 
f 
! 
' 
! 
: 
! 
0 ! 
: 
: 
i 
! 
! 
! 
u 
' 


RA BOOT COMMAND FILE - UNIBUS RA DISK 


THE UNIBUS ADAPTER TR LEVEL MUST BE DEPOSITED IN R1 AND THE 
UNIT NUMBER MUST BE DEPOSITED IN R3 BEFORE EXECUTING THIS PROCEDURE 


HALT PROCESSOR 

UNJAM SBI 

INIT PROCESSOR 

SET UP SCBB 

UDA-MSCP DISK 

TR LEVEL OF UNIBUS 

CSR ADDRESS OFFSET = 3F468 
PLUG # OF SYSTEM DISK 
BOOT BLOCK LBN (UNUSED) 
BOOT ULTRIX TO MULTI USER 
SET NO MACHINE CHECK EXPECTED 
START ROM PROGRAM 

WAIT FOR COMPLETION 


SHOW ADDRESS OF WORKING MEMORY 0x200 
LOAD PRIMARY BOOTSTRAP 
AND START IT 


There are several steps that you must follow to build an ULTRIX console diskette for 
the VAX—11/780 or VAX-11/785 processors: 


1. Insert the RX0O1 console diskette into the diskette drive. This is the diskette that 
you use to initialize your hardware when you power up the system. 


2. Run the mkconsole command: 


# etc/mkconsole 


This command assumes that /vmunix is the running kernel. When you run the 
mkconsole command, it displays a number of prompts and messages. 


During this step, the mkconsole command instructs you to insert a blank 
diskette. Replace the RXO1 console diskette in the drive with a blank diskette. 
When the new diskette is created, you can leave it in the diskette drive. 


3. If you have multiple memory controllers, you may have to edit the 
defboo.cmd, askboo.cmd, and restar.cmd command files to change the 
memory starting addresses or interleaving settings. Check with your field service 
representative to get the correct starting addresses or settings for your system. 


Before you can edit any of these files, you must extract them from the console 
diskette by using the arf£ command. After you modify the command files, 
replace them on the console diskette using the arf £ command before 
proceeding. 


3-26 Processor-Specific Boot Commands 


3.12.3 


The b orb ask boot command options are available, as described in Section 3.5. 


Updating VAX 6210/6220/6230/6240, VAX 
6310/6320/6330/6340/6350/6360, or VAX 6000-series Boot Command 
Files 


These processors store the boot data in Electrically Erasable Programmable Read- 
Only Memory (EEPROM). The EEPROMs contain such data as the default boot 
device information. 

Note 


You can use the /etc/mkconsole program to get precise instructions 
for updating your console boot defaults. 


To make changes to the EEPROM data, follow these steps: 
1. Shutdown your system and halt the processor. 


2. Reset the system by typing the initialize command at the console prompt. 
For example, type: 


>>>initialize 
3. Set the processor’s selector switch to the ‘‘Update’’ position. 


4. Enter the following commands to set the default multiuser boot command for a 
local disk and an HSC disk. 


— Fora local disk, use this syntax: 
set boot default /xmi: BIA# /bi:B/# /r5:10008 duunit# 


For example, type: 
>>>set boot default /xmi:e /bi:4 /r5:10008 dud 


— Foran HSC disk, use this syntax: 
set boot default /xmi: BIA# /bi: BI# /node: HSC# /r5:10008 duunit# 


For example, type: 
>>>set boot default /xmi:e /bi:4 /node:1 /r5:10008 dud 


The variable numbers must be expressed in hexadecimal notation. 


5. Enter the following commands to set the default single-user boot command for a 
local disk and an HSC disk. This allows a conversational boot to single user, 
using the b ask command. 


~ Fora local disk, use this syntax: 
set boot ask /xmi:B/A# /bi:Bi# /r5:1000b duunit# 
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For example, type: 
>>>set boot ask /xmi:e /bi:4 /r5:1000b dud 


— For an HSC disk, use this syntax: 
set boot ask /xmi:B/A# /bi:B/i# /node: HSC# /r5:1000b duunit# 


For example, type: 


>>>set boot ask /xmi:e /bi:4 /node:1 /r5:1000b dud 


The variable numbers must be expressed in hexadecimal notation. 
6. Reset the selector switch from the ‘‘Update’’ setting to its original setting. 
7. If you are booting a CI disk, make sure that the TKSO console tape is in the drive. 
8. Boot the system to multiuser or single user mode: 


— Boot to multiuser mode by typing: 


>>>b 


— Boot to single-user mode by typing: 


>>>b ask 


3.12.4 Changing the VAX 8200, VAX 8250, VAX 8300, and the VAX 8350 
Boot Data 


Each of these processors stores its boot data on Electrically Erasable Programmable 
Read-Only Memory (EEPROM). The EEPROMs contain such data as the default 
console baud rate and the default boot device. To make changes to this data, you 


must run the EEPROM utility, which is stored on the diskette labeled: UTIL PROG 
FLP. 


The EEPROM utility runs under the VAX Diagnostic Supervisor (VDS) software. 
Therefore, to run the EEPROM utility, you must boot the VDS software. The 
procedures for running the VDS software, as well as a complete description of the 


EEPROM utility’s functionality, is described in your processor-specific Owner’s 
Manual. 


It may be necessary to update the EEPROMs to boot the diskette by default. 


If your hardware supports an HSC configuration, you must build a new diskette to 
enable the HSC remote boot commands. 


To build the diskette, follow these steps: 


1. Invoke the mkconsole program by typing: 
# etc/mkconsole 


The program assumes that /vmunix is the running kernel. When you run the 


program, mkconsole prompts you to remove the RX50 diskette from the drive 
and insert a blank RX50 diskette in the same drive. 


2. Replace the RX50 diskette with a blank write-enabled RX50 diskette and press 
the RETURN key. The program responds with a brief message to explain its 
activity. At completion, the system prompt appears. 
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3.12.5 


After building the new diskette, your system is able to boot a remote HSC device. 


Updating the VAX 8500, VAX 8530, VAX 8550, VAX 8700, VAX 8800, 
and VAX 8810 Boot Command Files 


For each of these processors, there are several boot command files that you can use to 
start your system. The format of these command files is the same. Each command 
file contains setup and initialization commands, several DEPOSIT statements, and 
several startup statements. 


The DEPOSIT statements set the RO through R5 General Purpose Registers (GPRs). 
These GPRs are evaluated by the Virtual Memory Bootstrap program, VMB .EXE, to 
determine which device is to be booted. All of the DEPOSIT statements require 
hexadecimal values. 


The GPRs and their meanings are: 

e RO - Boot device type code 

e Ri — Processor-specific adapter information 

e R2-—- Controller number 

e R3-—- Unit number of the boot device 

e R4- Logical boot block number 

¢ R5-— Boot control flags 

Appendix B contains a complete listing of the values for each of these registers. Any 


of the register entries in these files can be changed, but the R1, R3, and RS registers 
are the ones most likely to change. 


Example 3-2 shows a sample boot command file (odara.com) fora VAX 8700 
processor. 


Example 3-2: Sample VAX 8700 Boot Command File 


SET VERIFY 
BDARA. COM 
REV 1.0 


COMMAND PROCEDURE TO BOOT ULTRIX FROM A BDA DISK. 


NEXT_PRIMARY is expected to point to the CPU that is to be used 
as the primary CPU. 


The following register deposits must be done before executing this 
command procedure or must be edited to correspond to the hardware 
configuration: 


Rl - Bus address information 
R3 - device unit number 


a ee ee 


SET TERMINAL OPAQ ! Set up logging 
SET DEFAULT HEXADECIMAL, PHYSICAL, LONGWORD 


INITIALIZE 
DEPOSIT RO 21 
!DEPOSIT R1 00 


Init primary 

BDA boot device type code 

Boot device bus address: 

<3:0>=BI node #, <5:4>=BI # 

<31:24>=optional controller letter specifier 


DEPOSIT R2 0 
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Example 3-2: (continued) 


!DEPOSIT R3 %D0 

SET DEFAULT HEXADECIMAL 
DEPOSIT R4 0 

DEPOSIT R5 1000B 


! Unit # of drive, decimal radix 
! Reset radix 

! Not applicable 

! bits purpose 
! <Q> ask for boot image name. 

! <1> boot single user 

1 <3> boot ultrix 

! <16> ignore memory soft errors. 

! Find 64kb of working memory; set cold 
! start bit 

IF NOT S$STATUS THEN @EXIT ! Boot if find was successful 

EXAMINE SP ! Show address of working memory + %X200 
LOAD/MAINMEMORY/START=@ VMB.EXE ! Load VMB into good mem + %X200 
START @ ! Start executing VMB 


FIND/MEM 


The steps to update the boot command files for these processors are: 


1, Exit the console mode. To do this, type a CTRL/P at the superuser prompt and 
type the word exit at the console mode prompt: 


# [CTRLP] 


>>>exit 
$ 


The $ prompt signifies that you are out of the console mode and under control of 
the operating system running on the PRO-380. 


2. Make a copy of the bdara.com file, with the name defboo.com. For the 
8800 processor, specify the subdirectory [8800], which contains the 
bdara.com 


$ COPY [8800]bdara.com defboo.com 


For the other VAX processors, copy the bdara.com file in the system default 
subdirectory: 


$ COPY bdara.com defboo.com 


Caution 


Do not edit the bdara.com file. This file is required for future 
ULTRIX installations or may be needed to boot alternate system 
disks. 


3. Edit the defboo.com file. You must use the EDT editor as described in the 
appropriate Console Operator’s Guide. This editor is invoked with the RUN EDT 
command, followed by the file name that you want to edit: 


S$ RUN EDT 
EDT> defbook.com 


The entries that you may have to change are the R1, R3, and RS register entries. 
At a minimum, you must remove the exclamation points (!) from the beginning 
of the R1 and R3 lines. 


The R1 register entry specifies — from the left-most bits — the following: 


— Bits 0 to 3 specify the number of the BI adapter node which is connected to 
the BUA. 


— Bits 4 and 5 specify the NBIA adapter number. 
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3.12.6 


— Bits 6 through 31 of the R1 register must be zero. 
The R3 register specifies the unit (plug) number of the system disk drive. 


The RS register entry should read 10008, which specifies booting the 
ULTRIX operating system to multiuser mode. 


. Exit the defboo.com file (after making the appropriate changes) and return to 


the $ prompt. 


Make a copy of the defboo.com file, and name the copy askboo.com. For 
example, type: 


$ COPY defboo.com askboo.com 
$ 


The system uses the askboo.com file to boot the system in conversational 
mode. 


. Edit the askboo.com file, using the EDT editor: 


S$ RUN EDT 
EDT> askboo.com 


The only register that you change is the R5 register. The R5 register entry should 
read 1000B. This causes the VMB.EXE program to boot the ULTRIX operating 
system to conversational single-user mode as described in Chapter 2. 


. Exit the askboo.conm file (after making the appropriate changes) and return to 


the $ prompt. 


. Return to the console monitor prompt by running the control program: 


$ RUN CONTROL 


This command causes the system to redisplay the console monitor prompt >>>. 


. Return the console to the ULTRIX superuser prompt: 


>>>set term prog 
# 


The # prompt indicates that you have returned to the ULTRIX operating system 
and can continue normal operations. You can now use the b and b ask boot 
commands to boot the system, as described in Section 3.8. 


Updating the VAX 8820/8830/8840 Boot Command Files 


There are boot command files for the VAX 8820/8830/8840 processors that you use 
to start your system. The format of these command files is the same. Each 
command file contains setup and initialization commands, several DEPOSIT 
statements, and several startup statements. 


The DEPOSIT statements set the RO through R5 General Purpose Registers (GPRs). 
These GPRs are evaluated by the Virtual Memory Bootstrap program VMB .EXE, to 
determine which device is to be booted. All of the DEPOSIT statements require 
hexadecimal values. 


The GPRs and their meanings are: 


RO — Boot device type code 
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Ri — Processor-specific adapter information 
R2 — Controller number 

R3 — Unit number of the boot device 

R4 — Logical boot block number 

R5 — Boot control flags 


Appendix B contains a complete listing of the values for each of these registers. Any 
of the register entries in these files can be changed, but the R1, R3, and RS registers 
are the ones most likely to change. 


To update the boot command files, follow these steps: 


l. 


Exit the console mode. To do this, type a CTRL/P at the superuser prompt: 
# 


>>> 
The >>> prompt signifies that you are running under control of the console 
operating system. 


Make a copy of the bdara.cmd file with the name defboo.cmd. Copy the 
bdara.cmd file in the system default subdirectory: 


>>>COPY bdara.cmd defboo.cmd 


Edit the defboo.cmd file. You must use the EDT editor as described in the 
appropriate Console Operator’s Guide. This editor is invoked with the 
edit/edt command, followed by the file name that you want to edit: 


>>>edit/edt defboo.cmd 


The entries that you may have to change are the R1, R3, and RS register entries. 
At a minimum, you must remove the exclamation points (!) from the beginning 
of the R1 and R3 lines. 


The R1 register entry specifies — from the left-most bits — the following: 


~— Bits 0 to 3 specify the number of the BI adapter node which is connected to 
the BUA. 


— Bits 4 and 5 specify the NBIA adapter number. 
— Bits 6 through 31 of the R1 register must be zero. 
The R3 register specifies the unit (plug) number of the system disk drive. 


The R5 register entry should read 10008, which specifies booting the 
ULTRIX operating system to multiuser mode. 


Exit the defboo.cmd file (after making the appropriate changes) and return to 
the >>> prompt. 


. Make a copy of the defboo.cmd file, and name the copy askboo.cmd. For 


example, type: 


>>>COPY defboo.cmd askboo.cmd 
>>> 


The system uses the askboo.cmd file to boot the system in conversational 
mode. 
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6. Edit the askboo.cmd file, using the EDT editor: 


>>>edit/edt askboo.cmd 


The only register that you change is the RS register. The R5 register entry should 
read 1000B. This causes the VMB.EXE program to boot the ULTRIX operating 
system to conversational single-user mode as described in Chapter 2. 


7, Exit the askboo.cmd file (after making the appropriate changes) and return to 
the >>> prompt. 


8. Return the console to the superuser prompt: 


>>>set term prog 
# 


The # prompt indicates that you have returned to the operating system and can 
continue normal operations. You can now use the b and b ask boot commands 
to boot the system, as described in Section 3.9. 


3.12.7 Updating the VAX 8600 and VAX 8650 Console RLO2 Disk 


The procedure in this section describes how to create boot command files that will 
boot the current running system disk. This procedure assumes that the /usr file 
system is mounted. 


To update the VAX 8600 or the VAX 8650 console RLO2 disks, run the 
mkconsole command. This command assumes that /vmunix is the running 
Kernel. Type: 


# etc/mkconsole 
The mkconsole command writes the ULTRIX support files, which include the 
defboo.comand askboo.conm files, to the console RLO2 disk. 


You can now use the b and b ask commands to boot the system, as described in 
Section 3.10. 


3.13 Booting a DECstation 3100 or a DECstation 2100 


3.13.1 


The following sections provide instructions for setting console environmental 
variables and for booting your processor. The boot command that you use depends 
on whether you are booting from disk, tape, or the network. 


Setting Console Environmental Variables 


You can define the default boot path and enable or disable automatic boot operations 
by setting specific console environmental variables. 


To set the bootpath variable, use this syntax: 
setenv bootpath rz(#,4,4)vmunix 


The bootpath variable sets the default boot device. The first # specifies the SCSI 
controller number. The default value is 0. The second # specifies the unit number of 
the system disk drive. The third # specifies the disk partition. The default value is 0. 
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3.13.2 


For example, to set the default boot device to an rz disk at controller 0, drive 1, 
partition 0, you would set the bootpath variable as: 


>>setenv bootpath rz(0,1,0) vmunix 


To set the bootmode variable, use this syntax: 
setenv bootmode variable 


The bootmode variable enables or disables automatic boot operation. To enable 
automatic boot to multiuser mode using the bootpath variable, set the bootmode 
variable to a. For example: 


>>setenv bootmode a 


To disable the automatic boot operation (that is, to suppress an automatic boot to 
multiuser mode after the RESET button has been depressed or as the result of a 
power on), set the bootmode variable to asterisk (“). For example: 


>>setenv bootmode * 


You can also set other console environmental variables. To get a listing of all of the 
variables, type: 
>>printenv 


For more information about the variables and for instructions on how to set each, see 
your hardware manual. 


Booting a System Disk 


You can boot the default disk or an alternate disk to either single-user or multiuser 
mode. The following list specifies the boot commands: 


e To boot the default disk or the system disk to single-user mode, type: 


>>boot 
The system boots the device that was set in the bootpath console 
environmental variable described previously. 


¢ To boot the default disk or the system disk to multiuser mode, type: 


>>auto 
The system boots the device that was set in the bootpath console 
environmental variable described previously. 

e To boot an alternate disk or kernel image to single-user mode, type: 
>> boot -f rz(0, 4,0)vmunix.new 


e To boot an alternate disk or kernel image to multiuser mode, type: 


>> setenv bootpath rz(0, #,0)vmunix.new 
>> auto 


For additional information on startup modes, see Chapter 2. 
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3.13.3 Booting a TK50 Tape 


3.13.4 


3.13.5 


When doing an installation or booting the standalone kernel for system management 
tasks, you may have to boot a TK50 tape. After installing the TK50 boot tape, type: 


>>test -c 


The console subsystem displays information that identifies the unit number of your 
tape drive and various other assignments. (Use this information to define the tape 
drive unit number (#) when you enter the boot command later on.) 


After displaying identification information, the console subsystem reissues its prompt. 
Now you can enter the boot command using this format: 


boot -f tz(0, #) 


For example, to boot a SCSI tape (tz) at controller 0, drive 5, type: 
>>boot -f tz (0,5) 


Booting from the Network 

You boot from the network when you are: 

e Booting a diskless system 

e Initiating an installation from a remote server 

e Booting a standalone kernel from a remote server, in order to perform system 


management tasks 


To boot the system from the network, enter this command: 
>>boot -f£ mop () 


Setting the Default Boot Device 


You set the default boot device when you want to change the boot default system 
disk permanently. 


To do this, follow these steps: 

1. Shut down your system. 

2. When the console prompt (>>) appears, type the command, using this format: 
setenv bootpath rz(4,4,4vmunix 


The bootpath variable sets the default boot device. The first # specifies the 
SCSI controller number. The default value is 0. The second # specifies the unit 
number of the system disk driver. The third # specifies the disk partition. The 
default value is 0. 
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For example, to set the default boot device to an rz disk at controller 0, drive 1, 
partition 0, you would set the bootpath variable as: 


>>setenv bootpath rz(0,1,0) vmunix 
3. Use the boot command to reboot your new system disk to single-user mode. 


4. Use the auto command to reboot your new system disk to multiuser mode. 


3.14 Booting the DECstation 5000 Series and the DECsystem 


3.14.1 


5900 


The following sections provide instructions for setting console environmental 
variables and for booting your processor. The boot command that you use depends 
on whether you are booting from disk, tape, CDROM or the network. 


Note 


If your ROMs are upgraded to TCF ROMs after ULTRIX has been 
installed, the bootpath environment variable is no longer used and you 
must set the boot environment variable. 


Determining the Default Slot Number 


To determine the default slot numbers for the controllers and devices configured on 
your system, type the following command at the console prompt: 


>> cnfg 


The cnfg command shows the options present on your system, displaying output 
like the following: 


7:KNOZ-AA DEC V5.3a TCFO (16 MB) 
6:PMAD-AA DEC V5.3a TCFO (enet:08) 
5:PMAZ~AA DEC V5.3a TCFO (SCSI=7) 
2:PMAZ-AA DEC V5.3a TCFO (SCSI=7) 
1:PMAG-AA DEC v5.3a TCFO 


The first column always displays slot numbers of the device controllers; the slot 
numbers differ with each configuration. 


Table 3-1 lists the boot information for default SCSI devices that are attached to the 
controllers identified by the letters "SCSI" in the fifth column of the cnfg command. 
display. Table 3-2 lists the boot information for default network devices that are 
attached to the controllers and identified by the letters "enet" in the fifth column of 
the cnfg command display. 
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3.14.2 


Table 3-1: Default SCSI Devices for the DS5000-200 


Boot cnfg Device Default Default 

Devices Controller Name Slot Controller 
Identifiers Number Number 

Tape SCSI tz 5 0 

Disk SCSI IZ 5 0 

CDROM _ SCSI IZ 5 0 


Table 3-2: Default Network Devices for the DS5000-200 


Boot enfg Device Default Default 
Devices Controller Name Slot Controller 

identifiers Number Number 
Network Options _enet —- 6 0 


Determining the Boot Device Number 


To determine the boot device number, use the cnfg command with the following 
syntax: 


cnfg_ slot_number 


For example, to determine the device number of a SCSI disk drive with a controller 
number of 0 and a slot number of 5, type the following command: 


>> enfg 5 


In the command’s display, the disk drive is identified by the letters "rz," followed by 
the device number (rz3, in the following example): 


5 PMAZ~-AA DEC V5.3a TCFO (SCSI = 7) 
DEV PID VID REV SCSI DEV 
rz3 RZ56 (C) DEC DEC 0200 DIR 

SEQ 


With this information, you are now able to boot your system or set your system’s 
environmental boot variable, because you know that the slot number of controller 0 is 
5, the device name is rz, and device number of the boot device attached to that 
controller is 3 (rz3). 
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Note 


If the cnfg slot_number command shows that you have multiple devices 
configured on the same controller, you will have to know which device is 
the boot device. If you do not know which device is the boot device, 
consult your system administrator. 


3.14.3 Setting the Console Environmental Variables 


3.14.3.1 


The following sections discuss how to set the console environmental variables for the 
boot and haltaction commands. To get a listing of the variables, type: 


>> printenv 


For more information about the variables and for instructions on how to set each, see 
your hardware manual. 


Setting the System Disk Boot Variable 


You can define the default boot path and enable or disable automatic boot operations 
by setting specific console environmental variables, depending on whether you will 
be booting from the system disk or from the network. 


The boot environmental variable sets the default boot device. To set the boot 
variable for the system disk, use the setenv command with the following syntax: 


setenv boot s/ot_number/device_name_number/unix_kernel [ -a] 


Replace slot_number with the slot number of the disk controller that is to be the 
default boot device. Replace device_name_number with the name and the device 
number of the default boot device. Replace unix_kernel with the pathname of the 
UNIX kernel that is to be the default kernel. 


Use the —a switch to enable booting to multiuser mode by default. 


Multiuser Mode — To set the boot environmental variable to boot to multiuser 
mode by default, you must set the -a switch and surround everything after the boot 
variable in double quotation marks ("). 


For example, to set the default boot device to an rz disk at slot 0, drive 1, with 
vmunix as the default kernel, and to set the default to boot to multiuser mode, type 
the following command: 


>> setenv boot "0/rz1/vmunix -a" 


Single-user Mode — To set the boot environmental variable to boot to single- 
user mode by default, do not set the -a switch. 


For example, to set the default boot device to an rz disk at slot 0, drive 1, with 
vmunix as the default kernel, and to set the default to boot to single-user mode, type 
the following command: 


>> setenv boot 0/rz1/vmunix 
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3.14.3.2 Setting the Network Boot Variable 


3.14.3.3 


3.14.4 


The boot variable sets the default boot device. To set the boot variable for the 
network, use the setenv command with the following syntax: 


setenv boot s/ot_number/mop{[-a] 


Replace slot_number with the slot number of the module that is to be the default boot 
device. 


Use the -a switch to enable booting to multiuser mode by default. 


Multiuser Mode — To set the boot environmental variable to boot to multiuser 
mode by default, set the -a switch and surround everything after the boot variable 
in double quotation marks ("). 


For example, to set the default boot device to the network at slot 0, and to set the 
default to boot to multiuser mode, type the following command: 


>> setenv boot "0/mop -a" 


Single-user Mode -— To set the boot environmental variable to boot to single- 
user mode by default, do not set the -a switch. For example, to set the default boot 
device to the network at slot 0, and to set the default to boot to single-user mode, 
type the following command: 


>> setenv boot 0/mop 


Setting the haltaction Variable 


The haltaction variable enables or disables automatic boot operation. To set the 
haltaction variable, use the setenv command with the following syntax: 


setenv haltaction variable 


To enable automatic boot mode using the boot variable, set the haltaction 
variable to b by typing the following command: 


>> setenv haltaction b 


To disable the automatic boot operation (that is, to suppress an automatic reboot after 
the reset button has been depressed or when power to the machine is turned on), set 
the haltaction variable to h by typing the following command: 


>> setenv haltaction h 
To force the system to restart when the reset button is pressed, and thereby do a 


memory dump, set the haltaction variable to r by typing the following 
command: . 


>> setenv haltaction r 


Booting from a Disk 


You can boot the system disk or an alternate disk or alternate kernel to either single- 
user or multiuser mode. 
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3.14.4.1 


3.14.4.2 


3.14.5 


3.14.6 


Booting from the System Disk 


To boot the system disk to single-user or multiuser mode, type the following 
command: 


>> boot 


The system boots the device that was set in the boot console environmental 
variable. 


Booting from an Alternate Disk or Kernel 


To boot an alternate disk or kernel image to single-user or multiuser mode use the 
boot command with the following syntax: 


boot s/ot_number/device_name_number/unix_kernel [ -a] 


Replace slot_number with the slot number of the controller attached to your boot 
device. Replace device_name_number with the name and the number of the boot 
device. Replace unix_kernel with the pathname of the alternate kernel. Use the -a 
switch and surround everything after the boot variable with double quotes to enable 
booting to multiuser mode. 


For example, to boot an alternate kernel at slot 0, drive 5 to multiuser mode, type the 
following command: 


>> boot "0/rz5/vmunix.new -a" 


Booting from a TK50 Tape 


When doing an installation or, when booting the standalone kernel for system 
management tasks, you may have to boot the system from a TKS0 tape. After 
installing the TK50 boot tape, determine the device number of the drive for your 
device by following the instructions in Section 3.14.2. 


For example, if the TK50 is attached to a SCSI controller at slot 5 (this is the most 
common configuration), type the following command: 


>> enfg 5 

Use the boot command with the following syntax to boot your system: 
boot s/ot_numberAzdevice_number 

Replace slot_number with the slot number of the tape controller. Replace 


device_number with the device number of the SCSI tape drive from which you are 
booting. 


For example, to boot a SCSI tape (tz) at slot 5, drive 5, type the following 
command: 


>> boot 5/tz5 


Booting from a CDROM 


To boot the system, load the CDROM into the drive and wait for the drive to be on 
line and ready. 


Determine the number of the drive for your device, as described in Section 3.14.2. 
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3.14.7 


For example, if the CDROM is attached to a SCSI controller at slot 5 (this is the 
most common configuration), type the following command: 


>> enfg 5 


A display appears that shows what is assigned to each device number on your 
system. 


Use the boot command with the following syntax to boot your system: 
boot s/ot_number/rzdevice_number/vmunix[-a] 


Replace slot-number with the slot number of the CDROM controller. Replace 
device-number with the device number of your RRD40 optical disk drive. 

Use the -a switch and surround everything after the boot variable with double quotes 
to enable booting to multiuser mode. 


For example, to boot the system to multiuser mode from RRD40 optical disk drive 
number 4 on slot number 1, type the following command: 


>> boot "1/rz4/vmunix -a" 


Booting from the Network 

You boot your system from the network when you do one of the following: 

e Boot a diskless system 

e Initiate an installation from a remote server 

e Boot a standalone kernel from a remote server to perform system management 
tasks 

To boot the system from the network, use the boot command with the following 

syntax: 

boot s/ot_number/mop [-a} 

Replace slot_number with the slot number of the network controller. Use the -a 


switch and surround everything after the boot variable with double quotes to enable 
booting to multiuser mode. 


For example, to boot from the network to multiuser mode on slot number 6, type the 
following command: 


>> boot "6/mop -a" 


3.15 Booting the DECstation 5400 


3.15.1 


The following sections provide instructions for setting console environmental 
variables and for booting your processor. The boot command that you use depends 
on whether you are booting from disk, tape, or the network. 


Setting Console Environmental Variables 


You can define the default boot path and enable or disable automatic boot operations 
by setting specific console environmental variables. 


To set the bootpath variable, use the setenv command with this syntax: 


setenv bootpath rz(4,4,4)vmunix 
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3.15.2 


The bootpath variable sets the default boot device. The first number sign specifies 
the controller number; the default value is 0. The second number sign specifies the 
unit number of the system disk drive. The third number sign specifies the disk offset; 
the default value is 0. 


For example, to set the default boot device to an rf disk at controller 0, drive 1, 
partition 0, you would set the bootpath variable as follows: 


>>setenv bootpath rf(0,1,0) vmunix 


To set the bootmode variable, use the setenv command with this syntax: 
setenv bootmode variable 


The bootmode variable enables or disables automatic boot operation. To enable 
automatic boot to multiuser mode using the bootpath variable, set the haltaction 
variable to a. For example: 


>>setenv haltaction a 


To disable the automatic boot operation (that is, to suppress an automatic reboot after 
the RESET button has been depressed or when power to the machine is turned on), 
set the bootmode variable to asterisk (*). For example: 


>>setenv bootmode * 


To force the system to restart when the reset button is pressed, and thereby do a 
memory dump, set the bootmode variable to r. For example: 


>>setenv bootmode r 


You can also set other console environmental variables. To get a listing of all of the 
variables, type: 


>>printenv 


For more information about the variables and for instructions on how to set each, see 
your hardware manual. 


Booting a System Disk 


You can boot the default disk or an alternate disk to either single-user or multiuser 
mode. The following list specifies the boot commands: 


e To boot the default disk or the system disk to single-user mode, type: 


>>boot ~-s 


The system boots the device that was set in the bootpath console 
environmental variable described previously. 
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3.15.3 


3.15.4 


e To boot the default disk or the system disk to multiuser mode, type: 


>>boot 
The system boots the device that was set in the bootpath console 
environmental variable described previously. 

e To boot an alternate disk or kernel image to single-user mode, type: 
>> boot -s -f tm(0, 4#,0)vmunix.new 


e¢ To boot an alternate disk or kernel image to multiuser mode, type: 
>> boot -f tm(0, 4,0)vmunix.new 


For additional information on startup modes, see Chapter 2. 


Booting a TK50 Tape 


When doing an installation or booting the standalone kernel for system management 
tasks, you may have to boot a TKS0 tape. After installing the TK50 boot tape, to 
invoke the console type: 


>>maint 


When the console prompt (>>>) appears, type this command: 


>>>show devices 


The console subsystem displays information that identifies the unit number of your 
tape drive and various other assignments. Use this information to define the tape 
drive unit number (#) when you enter the boot command later on. Type this 
command to return to the RISC console: 


>>>exit 


After displaying identification information, the console subsystem reissues its prompt. 
Now you can enter the boot command using this format: 


boot -f tm(0,4 


For example, to boot a tape (tm) at controller 0, drive 5, type: 
>>boot -f tm(0,5) 


Booting from the Network 

You boot from the network when you are: 

e Booting a diskless system 

e Initiating an installation from a remote server 


e Booting a standalone kernel from a remote server in order to perform system 
management tasks 
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3.15.5 


To boot the system from the network, enter this command: 
>>boot -f mop() 


Setting the Default Boot Device 


You set the default boot device when you want to change the boot default system 
disk permanently. 


To do this, follow these steps: 

1. Shutdown your system. 

2. When the console prompt (>>) appears, type the command, using this format: 
setenv bootpath rf(4,4,4vmunix 


The bootpath variable sets the default boot device. The first # specifies the 
controller number. The default value is 0. The second # specifies the unit 
number of the system disk driver. The third # specifies the disk offset. The 
default value is 0. 


For example, to set the default boot device to an rf disk at controller 0, drive 1, 
offset 0, you would set the bootpath variable as: 


>>setenv bootpath rf(0,1,0) vmunix 


3. Use the boot -s command to reboot your new system disk to single-user mode. 


4. Use the boot command without the single user option to reboot your new 
system disk to multiuser mode. 


3.16 Booting the DECsystem 5810/5820/5830/5840 


3.16.1 


The following sections provide instructions for setting console environmental 
variables and for booting your processor. The boot command that you use depends 
on whether you are booting from disk or tape. 


Setting Console Environmental Variables 


You can define the default boot path and enable or disable automatic boot operations 
by setting specific console environmental variables. 


To set the bootpath variable, use this syntax: 
setenv bootpath ra(/x0s/ot-number /bnode-number /¢ Cl-number,#,#)vmunix 


The bootpath variable sets the default boot device. Replace slot-number with 
the slot number of your XMI-to-BI bus adapter (XBI). Replace node-number with 
the node number on the XBI where your controller is located. Replace CI~number 
with the CI node number. The first # specifies the unit number of the system disk 
drive. The second # specifies the disk offset. The default value is 0. 


For example, to set the default boot device to an ra disk with an HSC controller 
connected to CI slot number 4, and a BI adapter in slot E (hex) drive 1, partition 0, 
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3.16.2 


3.16.3 


you would set the bootpath variable as: 


>>setenv bootpath ra(/x0xe/b4/c6,1,0) vmunix 


You can also set other console environment variables. To get a listing of all of the 
variables, type: 


>>printenv 


For more information about the variables and for instructions on how to set each, see 
your hardware manual. 


Booting a System Disk 


You can boot the default disk or an alternate disk to either single-user or multiuser 
mode. The following list specifies the boot commands: 


1. To boot the default disk or the system disk to single-user mode, type: 


>>boot -s 
The system boots the device that was set in the bootpath console 
environmental variable described previously. 


2. To boot the default disk or the system disk to multiuser mode, type: 


>>boot 


The system boots the device that was set in the bootpath console 
environmental variable described previously. 


3. To boot an alternate disk or kernel image to single-user mode, type: 


>> boot -s -f ra(/xsiot-number /b node-number /¢ Cl-number, #,0)vmunix.new 


4. To boot an alternate disk or kernel image to multiuser mode, type: 


>> boot -f ra(/xslot-number /b node-number /¢ Ci-number, #,0)vmunix.new 


For additional information on startup modes, see Chapter 2. 


Booting a TK50 Tape 


When doing an installation or booting the standalone kernel for system management 
tasks, you may have to boot a TK50 tape. After installing the TK50 boot tape, type: 


>>maint 


to invoke the console. When the console prompt (>>>) appears, type this command: 


>>show config 


The console subsystem displays information that identifies what is assigned to each 
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3.16.4 


slot number on your system. The display looks like this: 


Type Rev 
1+ KN58A/A (8081) 0000 
2 KN58A/B 
O+ MS62A (4001) 0002 
E+ DWMBA/A (2001) 0002 
XBI E 
1+ DWMBA/B (2107) OOOA 
2+ KDB50 (010E) 131C¢ 
4+ CIBCA (0108) 41C2 
6+ TBK70 (410B) 0307 
C+ DEBNI (0118) 0100 


Record the slot number of your XBI adapter, which is hexadecimal E in the example. 
Also record the node number of your TBK70 controller, which is 6 in the example 
(Do not include the plus (+) sign that appears in the output.) 

Type this command to return to the RISC console: 


>>>exit 


After displaying identification information, the console subsystem reissues its prompt. 
Now you can enter the boot command using this format: 


boot -f tms(/x0xs/ot-number/bnode-number, unit-number) 


Replace slot-number with the slot number of your XMI-to-BI bus adapter (XBJ). 
Replace node-number with the node number of the XBI where your TBK70 
controller is located. Replace unit~number with the unit number of your TBK70 
controller. The unit number is always the same as the node number on the XBI 
where your TBK70 controller is located. 


For example, to boot the system from XBI slot E (hex) for a TBK70 controller 
located on XBI node 6 type: 


>>boot -f tms(/x0xe/b6, 6) 


Setting the Default Boot Device 


You set the default boot device when you want to change the boot default system 
disk permanently. 

To do this, follow these steps: 

1. Shutdown your system. 


2. Set the default boot device by setting the bootpath variable. For information 
on setting the boot path variable, see Section 3.16.1. 


Use the boot -s command to reboot your new system disk to single-user mode. 


4. Use the boot command without the single user option to reboot your new 
system disk to multiuser mode. 
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The standalone ULTRIX environment is a diskless environment that has its miniroot 
file system within the data space of the running kernel. It is used to initiate ULTRIX 
installations. 


The primary purpose of the standalone ULTRIX environment is to support the initial 
phases of an installation, which include selecting input and output devices, as well as 
restoring the root file system image to the target system disk. Throughout the 
installation process, full ULTRIX device drivers are used. 


A secondary purpose of the standalone ULTRIX environment is to support system 
management activities. These activities include: 


e Restoring a damaged root file system 

e Checking the consistency of the root file system 

e Restoring the boot block image 

e Performing disk maintenance operations 

The commands included in the standalone ULTRIX environment are those commands 
that assist in recovering from root file system corruption, and those that help perform 
general file system and disk maintenance tasks. You should therefore consider the 
standalone ULTRIX environment a limited and intentionally small environment that 
does not perform like a full 

operating system environment. System management activities in the standalone 


ULTRIX environment should be performed by those individuals who have extensive 
ULTRIX or UNIX operating systems experience. 


The sections in this chapter: 
e Explain how to invoke the standalone ULTRIX environment 
e Identify some of the more commonly used functional capabilities 


e Describe how to extend the standalone ULTRIX environment so that additional 
commands can be used. 


4.1 Invoking the Standalone ULTRIX Environment 


The media and the commands that you use to invoke the standalone ULTRIX 
environment are dependent on the type of processor that you are using. These media 
and commands are identified and described in the Guide to Installing ULTRIX. 


As part of the installation, the system prompts you to select one of three options: 
e Basic Installation 
e Advanced Installation 


e System Management 


Choose the third item, System Management, to invoke the Standalone ULTRIX 
Environment. The system responds by placing the system in single-user mode and 
by displaying the # shell prompt. 


4.2 Standalone ULTRIX Environment Capabilities 


4.3 


The standalone ULTRIX environment enables you to perform all of the typical 
system management activities. The only difference is that, in some cases, you have 
to use system primitives instead of the more advanced system commands. For 
example, to make a new file system, you must use the mk fs command instead of the 
newfs command. This is because of the space limitation imposed on the standalone 
ULTRIX environment. 


A limitation of the standalone ULTRIX environment is that only peripheral devices 
connected to controllers that have been assigned standard, fixed, CSR addresses are 
accessible when making special device files. At boot time, the system does not 
configure controllers assigned floating CSR addresses. When the special device files 
have been created with the MAKEDEV command, you have access to the functional 
capabilities of the standalone ULTRIX environment. These functional capabilities 
include the ability to do the following: 


e Repair corrupted file systems with the fsck command 

e Create new file systems with the mkfs command 

e Restore the boot block with the dd command 

e Restore file systems with the restore command 

e Maintain disks with the rzdisk or radisk commands 

e Mount other disks and file systems with the mount command 

An example of the standalone ULTRIX environment’s functional capability is 


described in the Guide to Backup and Restore. The description explains how to 
restore the root file system after a catastrophic event has occurred. 


Extending the Standalone ULTRIX Environment 


If you find that the commands and utilities provided by the standalone ULTRIX 
environment do not completely meet your needs, you can extend the environment to 
include access to other commands. To extend the standalone ULTRIX environment, 
perform the following steps: 


1. Make the device special files for the device that contains the target commands. 
To do this, change directories as follows: 


# cd /dev 


After changing directories, use the following syntax to create the special device 
files: 


MAKEDEVcevice 
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2. Mount the device. For example, to mount the /mnt file system, use the 
following format: 


# mount device /mnt 


This enables you to access any of the commands or files on that device. To see 
what commands and files are available, type: 


# 1ls /mnt 


The system responds by displaying the contents of /mnt. 
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This appendix identifies and defines the mnemonics that are used to attach any 
hardware or software device to your system. The mnemonics are used by the 
/dev/MAKEDEV shell script to create the character or block special files that 
represent each of the devices. The mnemonics also appear in the system 
configuration file, as described in the Guide to Configuration File Maintenance. 


Table A-1 lists the mnemonics in nine categories: generic, systems, consoles, disks, 
tapes, terminals, modems, printers, and others. The generic category lists the 
mnemonics of a general nature and includes memory, null, trace, and tty devices. 
The systems category lists the mnemonic for DECstation system setup. The consoles 
category lists the system console devices that the ULTRIX operating system uses. 
The disks, tapes, terminals, modems, and printers categories identify the appropriate 
mnemonics for those devices. The others category lists the mnemonic for DECstation 
devices. 


The description heading in Table A-1 identifies the corresponding device name. It 
does not define the mnemonic’s use. For detailed information on the use of each 
mnemonic in relation to both the MAKEDEV script and the system configuration file, 
refer to the reference pages in Section 4 of the ULTRIX Reference Pages. If on-line 
reference pages are available, you can also use the man command. For instance, 
enter the following command at the system prompt to display the reference page for 
the Small Computer System Interconnect (SCSI) disk controller driver: 


% Man rz 


Where appropriate, the SYNTAX section of the reference page defines the device’s 
syntax as it should appear, in the config file. Refer to /dev/MAKEDEV for 
additional software device mnemonics that MAKEDEV uses. Refer to MAKEDEV(8) in 
the ULTRIX Reference Pages for a description of the MAKEDEV utility. 


Table A-1 uses the convention of an asterisk (*) beside a mnemonic and a question 
mark (?) beside a device name to mean a variable number. The value of the variable 
number is dependent on the particular device. 


Table A-1: 


Category 


Generic 


Systems 


Consoles 


Disks 


Terminals 
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Devices Supported by MAKEDEV 


Mnemonic 


boot* 
audit 
drum 
mvax* 
vaxstation* 
std 
errlog 
kUmem 
kmem 
mem 
null 
trace 
tty 
local 


DECstation 


console 
crl 

cs* 
ctu* 
cty* 

cfi 
ttycp 


hp* 
ra* 
rb* 


rd* 
IZ 
rk* 
rl* 
rx* 
fd 


mu* 
tms* 
rv* 
ts* 
tu* 
st* 


tz* 


cxa* 
cxb* 
cxy* 
dfa* 
dhq* 
dhu* 
dhv* 
dmb* 


Description 


Boot and std devices by cpu number; for example, boot750 
Audit log device 

Kernel drum device 

All MicroVAX setups; for example, mvax2000 

A VAXstation 2000 setup; for example, vaxstation2000 
Standard devices with all console subsystems 

Error log device 

Kernel Unibus/Q-bus virtual memory 

Virtual main memory 

Physical memory 

A null device 

A trace device 

A character terminal device 

Customer-specific devices 


A DECstation setup (for example, a DECstation 3100) 


System console interface 

Console RLO2 disk interface for VAX 8670 

Console RX50 floppy interface for VAX 8770 

Console TUS8 cassette interface for VAX 11/725/730/750 
Console extra serial line units for VAX 8?70 

Console RX0O1 floppy interface for 11/78? 

Console line used as auxiliary terminal port 


MASSBUS disk interface for RM?? drives and RP?? devices 
UNIBUS/Q-bus/BI/HSC/DSSI MSCP disk controller interface 
UNIBUS IDC RLO2 disk controller interface 

for RB?? drives 
VAXstation 2000 and MicroVAX 2000 RD type drives 
SCSI disks (for example, the RZ56) 
UNIBUS RK?? disk controller interface 
UNIBUS/Q-bus RL?? disk controller interface 
VAXstation 2000 and MicroVAX 2000 RX type drives 
Floppy Disk (for example, the RX26) 


MASSBUS imagitape interface (for exampie, the TU78) 
UNIBUS/Q-bus/BI/HSC/DSSI TMSCP tape controller interface 
UNIBUS/Q-bus/BI TMSCP optical disk 
UNIBUS/Q-bus TS11/TSO5/TU80 magtape interface 
TE16/TU45/TU77 MASSBUS magtape interface 
VAXstation 2000 and MicroVAX 2000 TZKSO 

cartridge tape 
SCSI tapes (for example, the TZU50) 


Q-bus cxal6 

Q-bus cxb16 

Q—bus cxt08 

Q-—bus DFAO1 comm multiplexer 

Q-bus DHQ11 comm multiplexer 

UNIBUS DHU11 comm multiplexer 

Q-bus DHV11 comm multiplexer 

BI DMB32 comm multiplexer including dmbsp 
serial printer/plotter 


Table A-1: (continued) 


Category Mnemonic Description 


dhb* BI DHB32 comm multiplexer 
dmf* UNIBUS DMF32 comm multiplexer including dmfsp 
serial printer/plotter 

dmz* UNIBUS DMZ32 comm multiplexer 

dz UNIBUS DZ11 and DZ32 comm multiplexer 

sh* MicroVAX 2000, 8 serial line expansion option 

ss* VAXstation 2000 and MicroVAX 2000 basic 

4 serial line unit 

fc* VAXstation 60 basic 4 serial line unit 

dzq* Q—bus DZQ11 comm multiplexer 

dzv* Q-bus DZV11 comm multiplexer 

lta* Sets of 16 network local area terminals (LAT) 

pty* Sets of 16 network pseudoterminals 

qd* Q-bus VCB02 (QDSS) graphics controller/console 

qv* Q-bus VCBO1 (QVSS) graphics controller/console 

sm* VAXstation 2000 monochrome bitmap graphics/console 

sg* VAXstation 2000 color bitmap graphics console 

Ix VAXstation 8000 color high-performance 3D graphics 

fg* VAXstation 60 color bitmap graphics/console 
Modems dfa* DFAO1 integral modem communications device. 
Printers dmbsp* BI DMB32 serial printer/plotter 

dmfsp* UNIBUS DMF32 serial printer/plotter 

Ip* UNIBUS LP11 parallel line printer 

Ipv* Q-bus LP11 parallel line printer 
Packet filter _pfilt Packet filter devices; set of 64 
Other pm* mono/color bitmap graphics/mouse/modem 


/printer/terminals for DECstation 3100 
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The ULTRIX operating system uses I/O device drivers provided in the VMS Virtual 
Memory Bootstrap (VMB) program. The VMB program evaluates the contents of 
general purpose registers (GPRs) RO through R5 to determine which device is to be 
booted. Where appropriate, installation procedures are set up to build default boot 
command files to bootstrap the system disk. If you wish to tailor the contents of 
boot command files, you can edit and replace them as necessary. This appendix is 
provided as a reference to show the use of the GPRs by the VMB program. 


The following list defines the possible contents of the RO through RS registers. 
Values enclosed in < > signs define the bit positions for a particular parameter. For 
example: <07:00> means from bits 0 to 7. The notation MBZ means that the value 
must be zero. 


Note 
Input Parameters : (Registers expect hex values) 


e RO: 
— <07:00> boot device type code (RPB$B_DEVTYP) 


Hex Value Device 


0 MASSBUS device 
(RM02/3,RP04/5/6/7,RM80) 

1 RK06/7 

2 RLO1/2 

3 IDC(almost an RA80) on 
11/730 

11 UDA-S50 (note: values 1 - 1F 
are reserved for UNIBUS 
devices) 

20 HSC on CI 

21 BDA on BI 

40 Console block storage device 


— <15:08> reserved for future expansion 

— <31:16> device class dependent (RPB$W_ROUBVEC) 
@ UNIBUS — optional vector address; 0 implies use the default vector 
e MASSBUS — not used 


e Ri: Boot device’s bus address 


11/780 & 11/730 <31:04> MBZ 
<03:00> TR number of adapter 
11/750 <31:24> MBZ 
<23:00> address of the I/O 
page for the boot device’s 
adapter 


8600 <31:06> MBZ 
<05:04> A-bus Adapter 
number 
<03:00> TR number of the 
adapter 


8800 <31:06> MBZ 
<05:04> NBIA Adapter 
number 
<03:00> BI node number of 
the adapter 


e kR?2: 


All controllers: | <31:24> controller letter 
designator (optional) 


UNIBUS: <23:18> MBZ <17:00> 
UNIBUS address of the 
device’s CSR 


MASSBUS: <23:04> MBZ <03:00> 
adapter’s controller/formatter 
number 


CI: <23:08> MBZ <07:00> HSC 
node number (station address) 


e R3: Boot device unit number 
e R4: <31:0> MBZ 


e R5: Software boot control flags. The value -1 is reserved. 


The following table defines the software boot control flags used by the ULTRIX 
operating system. The first column of the table contains a comment about the 
ULTRIX operating system’s use of that control flag. If,this column is blank, the flag 
is not required by the ULTRIX operating system. The second column defines the bit 
number of the register. The third column defines the control flag. 


Table B-1: Software Boot Control Flags 


Comment Bit Meaning 
OPTIONAL 0 RPB$V_CONV 
(RB_LASKNAME) Conversational boot. This bit will force ULTRIXBOOT to prompt the user 


for an image name which would presumably be different from the default 
vmunix. If the DIAG is also on, then the user is prompted for the 
diagnostic supervisor image name. 
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Table B-1: 


Comment 


OPTIONAL 
(RB_SINGLE) 


REQUIRED 


OPTIONAL 


REQUIRED 


(continued) 


Bit 


10 


11 


12 


15 


16 


<27:17> 


Meaning 


RPB$V_DEBUG 
If this flag is set, the ULTRIX kernel image will be booted to single-user 
mode. 


RPB$V_INIBPT 
Initial breakpoint. If RPB$V_DEBUG is set, VMS executes a BPT 
instruction immediately after enabling mapping. 


RPB$V_BBLOCK 

Secondary boot from boot block. Secondary bootstrap is a single 512-byte 
block, whose LBN is specified in R4. R4 must be 0 for ULTRIX. 
RPB$V_DIAG (RB_LOADDS for ULTRIX) 

Diagnostic boot. Causes ULTRIXBOOT to load the appropriate diagnostic 
supervisor by CPU type. The default path is /field/e?saa.exe, where the 
partition is specified in bits <31:28> of this register. 

RPB$V_BOOBPT 


Bootstrap breakpoint. Stops the primary and secondary bootstraps with a 
breakpoint instruction before testing memory. 

RPB$V_HEADER 

Image header. Takes the transfer address of the secondary bootstrap image 
from that file’s image header. If RPB$V_HEADER is not set, transfers 
control to the first byte of the secondary boot file. 

RPB$V_NOTEST 

Memory test inhibit. Sets a bit in the PFN bit map for each page of memory 
present. Does not test the memory. 

RPB$V_SOLICT 

File name. VM@ prompts for the name of a secondary bootstrap file. 
RPB$V_HALT 

Halt before transfer. Executes a HALT instruction before transferring control 
to the secondary bootstrap. 

RPB$V_NOPFND 

No PEN deletion (not implemented; intended to tell VM@ not to read a file 
from the boot device that identifies bad or reserved memory pages, so that 
VM@ does not mark these pages as valid in the PFN bitmap). 
RPB$V_MPM 

Specifies that multiport memory is to be used for the total executive memory 
requirement. No local memory is to be used. This is for tightly coupled 
multiprocessing. 

RPB$V_USEMPM 

Specifies that multiport memory should be used in addition to local memory, 
as though both were one single pool of pages. 

RPB$V_MEMTEST 

Specifies that a more extensive algorithm be used when testing main memory 
for hardware uncorrectable (RDS) errors. 

RPB$V_FINDMEM 

Requests use of MA780 memory if MS780 is insufficient for booting. Used 
for 11/782 installations. 

RPB$V_AUTOTEST 

Used by Diagnostic Supervisor. 

RPB$V_CRDTEST 

Specifies that memory pages with correctable (CRD) errors NOT be 
discarded at bootstrap time. By default, pages with CRD errors are removed 
from use during the bootstrap memory test. 


MBZ - Reserved for future expansion. 
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Table B-1: (continued) 


Comment - Bit Meaning 
OPTIONAL <31:28> Redefines the default load file system partition. This field is used primarily 
(DIAG BOOT) with DIAG. The corresponding partition numbers and letters are: 


“ANDMNPWN © 
tdinu bow wd tou 
sm homo Oo 


SP Must be set to 0x200 
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Technical Support 


If you need help deciding which documentation best meets your needs, call 800-343-4040 before placing 


your electronic, telephone, or direct mail order. 


Electronic Orders 


To place an order at the Electronic Store, dial 800-234-1998 using a 1200- or 2400-baud modem from 
anywhere in the USA, Canada, or Puerto Rico. If you need assistance using the Electronic Store, call 


800-DIGITAL (800-344-4825). 


Telephone and Direct Mail Orders 
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Continental USA, 800-DIGITAL 
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Puerto Rico 809-754-7575 
Canada 800-267-6215 
International 

Internal" 


Contact 


Digital Equipment Corporation 
P.O. Box CS2008 
Nashua, New Hampshire 03061 


Local Digital Subsidiary 


Digital Equipment of Canada 

Attn: DECdirect Operations KAO2/2 
P.O. Box 13000 

100 Herzberg Road 

Kanata, Ontario, Canada K2K 2A6 


Local Digital subsidiary or 
approved distributor 


SSB Order Processing - WMO/E15 
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Reader’s Comments ULTRIX 
Guide to System Shutdown and Startup 
AA-ME91C-TE 





Please use this postage-paid form to comment on this manual. If you require a written reply to a software 
problem and are eligible to receive one under Software Performance Report (SPR) service, submit your 
comments on an SPR form. 


Thank you for your assistance. 


Please rate this manual: Excellent Good Fair Poor 
Accuracy (software works as manual says) O oO O O 
Completeness (enough information) O O O O 
Clarity (easy to understand) QO O im) Cj 
Organization (structure of subject matter) 0 a) O O 
Figures (useful) O 0 C) a) 
Examples (useful) O -) O C) 
Index (ability to find topic) im) O C O 
Page layout (easy to find information) O O Oo C] 
What would you like to see more/less of? 

What do you like best about this manual? 

What do you like least about this manual? 

Please list errors you have found in this manual: 

Page Description 

Additional comments or suggestions to improve this manual: 

What version of the software described by this manual are you using? 

IN i tg i DEE 

CCNY a aa ee ee Date 


Mailing Address 
Email _.- es C(CCSCt‘“‘(S:S@éPPhonlee’ 


-oc--- Do Not Tear — Fold Here and Tape -------------- 9-2 een Sak tan Bnet teehee hettatatettetetate 


djilg i" NO POSTAGE 
NECESSARY 


IF MAILED IN THE 


UNITED STATES 
San ee] 
eaeeger en onal 
a en 
BUSINESS REPLY MAIL ae! 
ae en er | 
FIRST-CLASS MAIL PERMIT NO. 33 MAYNARD MA EEE 
he es eee Amie 
POSTAGE WILL BE PAID BY ADDRESSEE [eae ee | 
Ce eee ety 
RINNE 
DIGITAL EQUIPMENT CORPORATION 
OPEN SOFTWARE PUBLICATIONS MANAGER 
ZKO3-3/Y32 
110 SPIT BROOK ROAD 
NASHUA NH 03062-2698 
WWecngellatbevaelQangeUaddadasdadendantatoandatlaal 
woo nH--: Do Not Tear — Fold Here .------------- -- = - - - - 5 2 on er en enna: 
Cut 
Along 
Dotted 





Line 


Reader’s Comments ULTRIX 
Guide to System Shutdown and Startup 
AA-ME91C-TE 





Please use this postage-paid form to comment on this manual. If you require a written reply to a software 
problem and are eligible to receive one under Software Performance Report (SPR) service, submit your 
comments on an SPR form. 


Thank you for your assistance. 


Please rate this manual: Excellent Good Fair Poor 
Accuracy (software works as manual says) C) 0 OQ 0 
Completeness (enough information) 0 O O 2) 
Clarity (easy to understand) Oo CO CO CO 
Organization (structure of subject matter) oO C] | O 
Figures (useful) O Oo O CO) 
Examples (useful) O oO Oj Cc 
Index (ability to find topic) 0 0 O O 
Page layout (easy to find information) oO O O O 


What would you like to see more/less of? 


What do you like best about this manual? 


What do you like least about this manual? 


Please list errors you have found in this manual: 
Page Description 


Additional comments or suggestions to improve this manual: 


What version of the software described by this manual are you using? 


TNE / TNE i ha 2 Dp: 
Company ee eee Dal 
Mailing Address 

BT a oe ag a es, PHONE 


Do Not Tear — Fold Here and Tape ----------------------------- ee 


dj ilgli| tial ™ NO POSTAGE 
NECESSARY 

IF MAILED IN THE 

UNITED STATES 


BUSINESS REPLY MAIL 


POSTAGE WILL BE PAID BY ADDRESSEE 





DIGITAL EQUIPMENT CORPORATION 

OPEN SOFTWARE PUBLICATIONS MANAGER 
ZKO3-3/Y32 

110 SPIT BROOK ROAD 

NASHUA NH 03062-2698 


Cut 
Along 
Dotted 


a ee ne ee ee ee re ee ee 


